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Overview 



This section is an overview of the features and benefits of 
GSS-DRIVERS. It explains how you can use it to create a 
device-independent as well as an operating system-independent 
graphics environment for the AT&T UNIX™ PC. 



Background 

Let's begin with a little background on computer graphics 
standards and the products related to GSS-DRIVERS to clarify its 
role on the UNIX PC. 



Graphics Standards 

Standards organizations in both the United States and in Europe 
have been working for over a decade to generate both a graphics 
model for understanding and communicating graphics 
information, as well as a formal specification for the 
implementation of computer graphics. 

At first, progress was slow due to the complexity of the subject 
of computer graphics and its many specific applications. Also, at 
that time, computer graphics was expensive and primarily 
relegated to institutions with large budgets — aerospace firms or 
prestigious universities. Since the market for computer graphics 
was limited, and there were only a few manufacturers of 
graphics equipment, the need for standardization was satisfied 
by "de facto" standards established by the dominant 
manufacturers. 

With the emergence of integrated circuits powerful enough to 
support graphics and inexpensive enough to be available to the 
masses came the widespread use of computer graphics. Now 
graphics is employed in virtually every application area that can 
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use a computer because it is a much more effective and pleasant 
way to represent information. In some cases, entirely new 
applications are enabled by computer graphics, such as 
computer-aided drafting and engineering. 

The result of this development is a strong desire for 
standardization to create order in an industry rapidly expanding 
with new products and suppliers. Standardization of computer 
graphics makes programmers more productive by providing 
them with a stable graphics programming model. It also 
provides the opportunity to develop application programs that 
are independent of the computer system and the graphics input 
and output devices employed. 

The Association for Computing Machinery (ACM) and 
specifically SIGGRAPH (Special Interest Group on Computer 
Graphics) became involved early in the standardization effort. 
They published a pseudo-standard in 1979 called the CORE 
System paving the way for later work by American and 
international standards organizations. 

The efforts of the American National Standards Institute (ANSI) 
and the International Standards Organization (ISO) are now 
resulting in standards that create a uniform conceptual model of 
computer graphics for system designers, programmers and 
users, making device-independent graphics a viable goal. The 
standards are structured around three main interfaces— one at 
the programmer level, one at the device level and one for 
communications between computers (see Figure 1-1). 

The Graphical Kernel System, or GKS, defines a programmer 
interface to graphics. It provides source code portability by 
standardizing the functions and calling conventions of graphics 
subroutine libraries used by programmers to develop graphics 
applications. 

At the device level, the Virtual Device Interface, or VDI, allows 
device-independence by creating a logical graphics device 
interface. This interface allows a computer to control any 
graphics peripheral without regard for its individual peculiarities. 
Specific devices can then be matched to the generalized device 
interface by means of individual device driver programs, one 
driver for each device. 

A similar scheme is employed for graphics data transfer between 
processors over communications channels. Again, a logical 
interface allows different computers to communicate by 
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employing interface programs that are compatible with the 
standard protocol. In this case, the standards are the Virtual 
Device Metafile (VDM) and Presentation Level Protocol (PLP). 



FIGURE 1-1 Graphics Standards 
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Standards Implementation 

GSS-DRIVERS provides device-specific drivers based on the VDI 
standard for graphics peripherals. Besides standardizing 
graphics applications, GSS-DRIVERS greatly reduces the 
programming effort required to create a graphics program. The 
low level primitive operations and device peculiarities are 
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transparent to the programmer. Language bindings (interfaces) 
enable the programmer to incorporate graphics as subroutine 
calls based on the VDI standard interface. 



FIGURE 1-2 GSS Product Line 
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GSS-DRIVERS Features 

GSS-DRIVERS provides the following graphics capabilities 
through the standard VDI interface: 

a Normalized coordinate to device coordinate transformation 

□ Drawing of graphics primitives (objects) 



polylines 

polymarkers 

text 


circles 

arcs 

pie slices 


bars 


cells 


deification of attributes 


color 




fill 




style 
line style 
line width 





□ Text manipulation (Three text options are available: alpha 
text, graphics text and cursor text. Manipulations possible 
with each mode are listed in Table 1-1.) 

location 

size 

rotation 

font 

color 

underlining 

overstrike 

super- and subscripting 

alignment 

□ Cursor positioning 

□ Graphics input 

□ Status inquiry 

n Generates standard metafiles 

Since capabilities vary among graphics devices, GSS-DRIVERS is 
designed to emulate certain features. It also provides feedback 
to the caller about the actual capabilities of the currently open 
device. 
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TABLE 1-1 Text Options 






Manipulations 


Cursor Text 


Alpha Text 


Graphics Text 


Positioning 


Character Cell 


Anywhere 


Anywhere 




Boundary 


on display 


on display 






surface 


surface 


Scaling 


No 


Yes* 


Yes 


Rotation 


No 


No 


Yes 


Multiple Fonts 


No 


Yes 


Yes 


Bold Text 


Yes 


Yes 


No 


Color Selection 


Yes 


Yes 


Yes 


Underlining 


Yes 


Yes 


Yes** 


Overstriking 


No 


Yes 


No 


Super- and 
Subscripting 


No 


Yes 


No 


Quality Levels 


No 


Yes 


No 


Line Spacing 


No 


Yes 


Yes 


Reverse Video 


Yes 


No 


Yes*** 


Blink Text 


Yes 


No 


No 


Text Alignment 


No 


No 


Yes 


Variable Text 
Height 


No 


Yes* 


Yes 


Control Mode 


Cursor 


Graphics 


Graphics 




Addressing 


Mode 


Mode 




Mode 







The size of alpha text can be changed via the SET ALPHA 
TEXT FONT AND SIZE function. 

Graphics text can be underlined by specifying polyline 
primitives underneath the character string, 

Reverse Video can be selected for graphics text via the SET 
WRITING MODE function. 
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GSS-DRIVERS Functions 

GSS-DRIVERS provides an environment for the creation of 
graphics applications that can be transported to any system 
conforming to graphics standards. GSS-DRIVERS' high-level 
language bindings incorporate system-independent interfaces for 
file and character I/O to insure that graphics applications will be 
completely portable. 

The device drivers are stored as executable files on system mass 
storage. When a workstation is opened, the appropriate driver is 
spawned as a new process that lives until the workstation is 
closed. 

Specifically, GSS-DRIVERS provides these functions: 

□ device driver management 
a coordinate transformation 

□ character and file I/O for high-level languages 

□ emulation of certain graphics primitives 

□ error reporting 

These functions are discussed in more detail in Part 3, "System 
Architecture." 



Device Driver Management 

A system may potentially have many graphics input and output 
peripherals attached, each requiring a specific device driver to 
interface it to the system. GSS-DRIVERS receives requests for 
graphics peripherals from an application and spawns the proper 
device driver process when the workstation is opened. 

GSS-DRIVERS also incorporates a metafile driver that generates 
ANSI standard metafiles. This capability is invoked simply by 
assigning "METAFIL" as the output device. The metafile device 
driver creates a metafile that is saved on the system storage 
device. 

Metafiles may be read using a separate product called Metafile 
Interpreter. See the AT&T UNIX PC GSS-TOOLKIT Metafile 
Interpreter Programmer's Guide. 
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Coordinate Transformation 

Graphics information is passed to GSS-DRIVERS in normalized 
device coordinates (NDC 0-32767) that are independent of any 
particular device. The system uses information obtained from 
the device driver to scale the normalized coordinates to device 
coordinates that are consistent with the values used by a 
particular graphics device (for example, raster steps). It also 
transforms device coordinates into normalized coordinates on 
input. 



Character and File I/O 

Even though graphics device calls are standardized, it is still 
difficult to transport graphics applications across operating 
systems because of differences in the way a program performs 
character I/O (for example, when communicating with another 
computer). Therefore, GSS-DRIVERS' high-level language 
bindings provide a set of generic character I/O routines that 
standardize this interface as well. 

GSS-PRIVERS also provides a file I/O subsystem. Again, the 
goal is to make graphics applications completely portable to 
many systems. The file system is modeled after the UNIX 
hierarchical file structure including multilevel directories. 



Graphics Emulation 

The VDI is a robust standard that incorporates many advanced 
graphics capabilities. Frequently, the capabilities offered by a 
graphics device are only a subset of the total VDI possibilities. 
To insure application portability, some functions that are not 
supported by the device directly are emulated by GSS-DRIVERS. 
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Creating Graphics Applications 

The graphics functions of GSS-DRIVERS can be employed in two 
ways. The first way is to access them directly through low-level 
assembly language routine calls with the appropriate parameter 
lists. However, the calling mechanism is system dependent. 
The result is applications which are device-independent, but 
operating system-dependent. 

A second, preferred method insures computer-independence. 
This method uses language bindings that access graphics 
functions directly as high-level language calls with formal 
parameters. The C language binding provides an interface 
between the language source and the VDI interface. Calls in the 
source conform to the binding function definitions. The binding 
interface is linked in as an external subroutine library, insuring 
that your application will be completely portable across any 
GSS-DRIVERS-compatible system. 

After linking, the graphics application may be loaded and run 
just like any other program. 

The exact process for generating a new application is system 
specific. See Part 4, "Installation and Operation" for detailed 
information. Appendix A, "Conventions and Example," 
contains an example program. 



Overview 1 -9 



Error Codes 

GSS-DRIVERS returns a set of error codes to inform the 
application program of any unusual conditions. A detailed 
summary and explanation of error messages is contained in 
Appendix B, "Error Codes." 
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The GSS Graphics Reference 
Model 



This part describes the graphics reference model for computer 
graphics on which GSS-DRIVERS is based. An understanding of 
this model will clarify the organization of the later parts of this 
manual and will help you to use GSS-DRIVERS in an application 
program. 



The Reference Model 

The Reference Model is a result of the standards effort described 
in Part 1. It is built on the following basic concepts: 

□ graphics output 

□ graphics input 

□ transformations 

□ workstations 



Graphics Output 

Graphics output functions are abstractions of the basic actions an 
output device can perform, such as drawing a line or displaying 
text. Output functions include two groups of basic elements 
called output primitives and output attributes. Primitives result 
in visible images on the display surface. Attributes modify the 
appearance of displayed objects, by changing their color, for 
example. Later in this part how GSS-DRIVERS implements these 
functions is discussed. 
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Graphics Input 

Information input from a device as a result of an operator action 
is called graphics input. For example, graphics input occurs 
when an operator "picks" a location on the display surface with 
a mouse or crosshair cursor, or types in text at a keyboard. 



Transformations 

The point coordinates of graphics images must often be 
translated between different coordinate systems. This occurs at 
the application level when an operator wishes to scale or rotate 
an image. It also occurs when coordinates must be modified so 
that an image can be reproduced on graphics display devices of 
different sizes. 

The VDI standard is based on a special coordinate system called 
the Normalized Device Coordinate (NDC) System. In NDC 
space, locations are expressed as Cartesian coordinates with 
values between and 32767 representing the full coordinate 
space for all devices. GSS-DRIVERS then transforms the NDC 
points into the appropriate device coordinates. 



Workstations 

The graphics reference model employs the concept of a 
"workstation" to mean zero or more display devices, and zero or 
more input devices such as a keyboard and a mouse. At upper 
levels of the graphics system hierarchy (programmer level), 
workstations can be used to refer to a complete worksite, 
eliminating the need to reference each device explicitly. The VDI 
level deals with each individual device explicitly, so 
"workstation identifiers" are used to refer to a single generic 
graphics device such as a display, printer or plotter. 
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Additional Elements 

Other concepts included in the reference model such as 
windows, viewports, clipping and segments are implemented at 
higher levels (in the Kernel System, for example) and will not be 
discussed in connection with GSS-DRIVERS. Refer to AT&T 
UNIX PC GSS-TOOLK1T Kernel System for a discussion of these 
standard graphics functions and their implementation. 
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GSS-DRIVERS Graphics Functions 

The graphics functions, supported by GSS-DRIVERS, can be 
divided into five functional areas: 

□ Control functions 

□ Output functions 

□ Attribute functions 

□ Input functions 

□ Inquiry functions 

Control Functions 

The control functions allow the application program to control 
various aspects of the graphics subsystem. The major control 
functions are: 

Open Initializes a graphics device and sets defaults for 

Workstation attributes. It also returns information to the caller 
about the characteristics and capabilities of the 
device. This must be the first graphics operation 
performed in a program. 

Close Terminates graphics operations to a device. This 

Workstation must be the last graphics operation performed in 
a program. 

Clear Clears the surface of the workstation. It clears a 

Workstation CRT screen, prompts for new paper on a plotter, 

or displays all pending graphics to a printer and 

advances to top-of-form. 

Update Displays all pending graphics. 

Workstation 



Output Functions 

Output primitives are functions that generate graphics objects on 
the display surface. Point locations are specified by giving X,Y 
coordinates in Normalized Device Coordinate (NDC) space — a 
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Cartesian space with values ranging from to 32767 on each 
axis. (Locations outside this range may generate unpredictable 
and device-dependent results.) Output primitives include: 

Polyline Draws single vector or series of connected vectors 

specified by their vertices. A polyline must have 
at least a beginning and end point specified. 

Polymarker Draws a marker symbol at specified locations. 

Graphics Displays a text string at a specified location. 

Text Characters come in multiple fonts, and may be 

rotated or scaled (unlike alpha or cursor text). 

Cursor Text Displays a text string on a fixed rectangular grid. 
For form fill-out, cursor text is available in only 
one size and font, is not rotatable, and cannot be 
combined with graphics text, alpha text, or 
graphics. 

Cursor text is typically positioned on a discrete, 
device-dependent grid of rows and columns. 
(Typical values are 24 rows by 80 columns.) 

Alpha Text Displays a text string at a specified location. 

Alpha text has multiple fonts, variable interline 
spacing, underlining capabilities and other 
attributes used for generating formal documents. 

Filled Area Causes an area bounded by a specified set of 
vertices to be "painted" with a fill pattern. 

Bar Draws a bar (rectangular area) defined by two 

diagonally opposite vertices. The interior is 
painted with a fill pattern. 

Arc Draws an arc defined by a center point, the radius, 

and the starting and ending angles. 

Pie Slice Draws a pie slice defined by the center, radius and 

starting and ending angles. The interior is painted 
with a fill pattern. 

Circle Draws a circle defined by a center point and the 

radius. The interior is painted with a fill pattern. 

Cell Array Draws a rectangular array of pixels of a specified 
size at a specified position. The pixel colors that 
make up the array are defined by a set of color 
indices. 
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Attribute Functions 



Primitive attributes modify the appearance of output primitives. 
GSS-DRIVERS provides the following groups of primitive 
attribute functions: 



Character 
Attributes 



Polyline 
Attributes 



Polymarker 
Attributes 



Character attributes fall into two groups: graphics 
text attributes and alpha text attributes. 

Graphics text attributes control: 

□ height 

□ base line rotation 

□ color 

□ font 

a alignment 

Alpha text attributes control: 

□ position 

d line space 

d font and size 

□ color 

□ subscript/superscript 

□ underline 
a overstrike 

□ output quality (draft or final) 
Polyline control: 

d type 

□ width 

□ color 

Polymarker control: 

a type 

□ size 

□ color 
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Fill Fill control: 

Attributes 

□ type 

□ style 

□ color 

Color Assigns color values specified in red, green and 

Representa- blue primaries to color index numbers. Color 
tion attributes are then selected by index number. 



Background 
Index 



Sets color index for display background. 



Input Functions 

Input functions return information from the operator. Input 
functions operate in two modes: sample and request mode. In 
the sample mode, the input, if any, is returned immediately. In 
the request mode, the operator must complete the input function 
by actuating some control on the graphics input device (such as a 
button on a mouse). There are five types of graphics input: 

Input Locator The Input Locator Function returns the point 
location of the graphics input device (mouse, 
crosshair, joystick, trackball, cursor, etc.) in 
NDC units. 

Input The Input Valuator Function returns a scalar 

Valuator value between and 32767, corresponding to 

the status of a valuator device (potentiometer, 

slide control, etc.). 

Input Choice The Input Choice Function returns the status of 
a choice device (switch, function key, etc.) as an 
integer between and 32767. 

Input String The Input String Function allows text input 
from the keyboard. 

Read Cursor The Read Cursor Movement Keys function 
Movement returns the direction of cursor movement. 

Keys 
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Inquiry Functions 

Inquiry functions return information about the current state of 
the graphics subsystem including device capabilities and current 
attributes. Inquiry functions are provided to determine: 



Graphics 
primitives 



Cursor 

addressable 

text 

Alpha text 



□ current polyline attributes 
n current polymarker attributes 

□ current fill area attributes 

□ current graphics text attributes 

a the number of addressable character cells 

□ the current cursor address 

□ alpha text capabilities 

□ alpha text position 

□ alpha text font availability 

□ alpha text string length 

□ cursor text position (direct cursor text 
addressing — relative and absolute cursor text 
movement) 

□ cursor text string and screen erase 

□ reverse video 

□ graphics input cursor display 
a hard copy output 

□ plotter pen speed 

□ raster writing mode (sixteen Boolean 
operations between source and destination are 
supported) 

The details of all the GSS-DRIVERS graphics functions are 
provided in the subsequent reference parts. 



Additional 

functions 

control 
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Besides creating a basis for development of graphics standards, 
the Reference Model provides the programmer with a conceptual 
framework to aid in organizing an application. It also aids the 
programmer in communicating with other programmers and 
users and to interpret graphics tools, such as GSS-DRIVERS, by 
providing a structural context. The rest of this manual is based 
on the organization defined by the Graphics Reference Model. 
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Programming Tips 

A typical graphics application will consist of the following five 
steps: 

o Set up graphics control 

□ Define graphics primitive attributes 
a Output graphics primitives 

□ Input primitives or inquire on status 

□ Terminate graphics 

The intermediate three steps may be repeated numerous times 
prior to the last step. The general flow of a graphics application 
program is illustrated in Figure 2-1. 



FIGURE 2-1 Graphics Program Flow 
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Control 

The first command the application should invoke is Open 
Workstation. This command defines the type of device to be 
used, loads the device into memory if necessary, and returns 
information to the user regarding the capabilities of the device. 
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Coordinate Transformation Flag 

A key parameter specified by Open Workstation is the coordinate 
transformation flag. This flag indicates the aspect ratio of the 
display surface. The user may specify a display surface with 
32767 addressable locations in both directions or one with 32767 
addressable locations on the longest side (axis) and a lesser 
amount on the shorter side (axis). The number of addressable 
locations on the shorter side will be proportional to the actual 
aspect ratio of the physical display. 

The benefit of having the number of addressable locations match 
the aspect ratio of the display surface is that a "unit distance" is 
the same length along both axes. The disadvantage is that not 
all devices have the same display surface aspect ratio, and 
portions of the output may not fit on all displays. 

The advantage of specifying 32767 locations along both axes is 
that the aspect ratio of the working display surface is always the 
same, no matter what the shape of the physical display surface. 
A programmer's application output will always fit on the display 
surface if his parameters stay within the range to 32767. This 
provides for device-independent graphics applications. 



Prompting Flag 

Another parameter the user must provide to the Open 
Workstation command is the prompting flag. The use of this flaj 
is important when the graphics output device is a plotter, 
printer, or other device possibly requiring user attention. For 
example, on a two-pen plotter, the user may wish to display a 
chart containing four colors. When colors three and four are 
needed, the device driver will prompt the user to change the 
pens. The prompting flag indicates whether the user is 
prompted or whether the device driver ignores the color change 
commands. This may be useful for preliminary debugging runs 
of a program when the actual number of colors output is not 
important. 
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Device-Specific Data 

Open Workstation also returns an array of information detailing 
the capabilities of the device requested. This information 
includes the number of colors available, the number of text sizes 
available, the number of line styles available, etc. The 
application programmer can apply these facts to utilizing a 
device to its best advantage. For example, if a device has 
multiple colors, different lines of data on a chart can be 
represented with solid lines in different colors. If black and 
white are the only colors available, different line styles 
(combinations of dashes, dots and spaces) can be used to 
differentiate the lines of data on the same chart output to a 
different device. 

Another important device-specific parameter returned by Open 
Workstation is the number of different text sizes available. A 
few devices allow for text to be continuously scaled from one 
unit high to 32767 units high. Most other devices only provide 
four to six different text sizes. The programmer should consider 
the number of scaling options and the actual text sizes needed 
for the application. 



Control Mode 

After opening the workstation, the programmer should make 
sure the device is in the proper mode. The default condition sets 
Graphics Mode to "on" and Cursor Addressing Mode to "off." 
Certain functions only work when Cursor Addressing Mode is 
on, and other functions only when Cursor Addressing Mode is 
off. Cursor Addressing Mode is only applicable to CRT devices. 

Cursor-addressable text is mutually exclusive with graphics text 
and alpha text. Graphics text and alpha text are compatible and 
can be displayed simultaneously on the same display surface. 
The user should remember to call Enter Cursor Addressing Mode 
prior to executing any cursor addressable commands. 

If the device is not in Cursor Addressing Mode when a cursor- 
addressing command is executed, the exact results are not 
defined. This may "hang" the device and require restarting. In 
some instances, the device may ignore the cursor addressing 
command. On rare occasions, it may actually execute the 
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desired function. All possible side effects are not listed here 
since the actual effect depends on the state of the device prior to 
the cursor addressing command. Similarly, if graphics 
commands are issued when Cursor Addressing Mode is on, the 
results are not well defined. 



Error Handling 

Open Workstation and all other routines also return a value that 
indicates whether the requested command was completed 
successfully. A zero or positive value indicates a success; a 
negative value indicates unsuccessful. When using 
GSS-DRIVERS high-level language bindings, if a negative value 
is returned after issuing a call to Inquire VDI Error can be 
invoked to identify the specific error. Errors are described in 
Part 3, "System Architecture," and a table of error values is 
provided in Appendix B. 

Device drivers seldom return errors. They are programmed to 
perform the operation requested to the best of their ability. 
However, they will return file and communication I/O errors. 
Such errors prevent the driver from completing an operation. 

Cursor Addressing Mode has no effect on printers. It does not 
return errors but rather the functions are ignored. Inquire 
Current Cursor Text Address will return that the cursor text is 
not available. 



Setting Attributes 

Attribute setting routines always return the attribute value 
selected. This is either the closest value to the one requested or 
the specified default in cases where the requested value is out of 
range. For example, when the default line style is index 1 
(solid), out of range line types are mapped to 1. 
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Color Indices 

Color index attribute setting routines select the closest index to 
the one requested. This can have interesting side effects. If a 
negative color index is requested, the closest index that will be 
selected is 0. However, the default value for color index is 
black. If the CRT background color is black, all subsequent 
primitives with the default index are invisible on the CRT. 

If the programmer wants a specific color associated with a 
particular pen station, he must inform the user. This can be 
done several different ways, depending on the device. The 
programmer could document desired colors in the application 
manual. Alternatively, a message could be sent to the CRT at 
the beginning of the program informing the user of the colors 
expected for each color index and pen station. 



Text Rotation 

Another attribute, text rotation, is specified via the function Set 
Graphics Text String Baseline Rotation. 



Graphics Primitive Output 

Output functions are available to define graphics primitives 
including polylines, polymarkers, arcs, circles, bars and pie 
slices. Functions are also provided to describe alpha, graphics 
and cursor text. Locations are specified in Normalized Device 
Coordinates. In general, GSS-DRIVERS will honor any graphics 
primitive output specifications supplied by the programmer. 

However, when using the aspect ratio preservation mode, 
scaling primitives may be partially or totally clipped. For text 
and markers, the entire character or marker must be visible for it 
to be displayed. 

Also, when specifying fill, remember that filled areas are not 
outlined unless the fill interior style is hollow. To display a filled 
area (polygon, bar, circle, pie slice) with an outline, first fill the 
area with the fill style of solid, pattern or hatch. Then specify fill 
interior style of hollow for the same area. 
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Another point to remember is that the radius specified for circles 
and arcs is assumed to be along the x-axis. The specified radius 
takes priority over the radius that is determined by the center 
point and an arbitrary point of the arc/circle. Since circles and 
arcs are specified by a centerpoint and a radius, a circle cannot 
be displayed if its center point is not on the display surface. 



Input and Inquiry 

Functions that return arrays of data may overwrite application 
data, if the amount of space allocated is smaller than the size 
given to the VDI. For example, when invoking either Input 
String (request mode) or Input String (sample mode), the user 
may specify a different value via the maximum-length parameter 
than required by the defined array. If the maximum-length 
parameter indicates that forty characters can be input and the 
user only defines an array that is ten elements long, an 
additional thirty characters may overwrite a portion of memory 
not intended by the user. The results of this situation depends 
on the application. In some cases, the error may never be 
detected. 



The GSS Graphics Reference Model 2-15 



Pseudocode Example 

To help you understand the logical sequence of creating a 
graphics application with GSS-DRIVERS, we have included a 
programming example. The object of the example is to create a 
Gantt Chart representation of a processing plant construction 
project. 

A Gantt Chart shows the component activities of a project by 
functional area along with their relationship in time. They are 
conveniently shown in a horizontal bar format where each bar 
shows the duration of a particular activity. Figure 2-2 shows the 
desired graphics output. The required GSS-DRIVERS calls are 
described in pseudocode below. 

{ This is a pseudocode program to generate a Gantt Chart. Lines within 
the braces are comments. } 

program gantt; 

{Initialize and dimension variables for use in the rest of the program. 
This is done as in any other program. The required data types and 
allocations are indicated in the function specifications in the 
subsequent reference Part.} 

OPEN. WORKSTATION ; 

{ Opening the workstation sets defaults and returns information like size 
of plotting surface, pixel heights and colors that can be used by the 
application program to best draw the chart. This is device-specific 
information reflecting the characteristics of the device being opened. } 

{ Note that OPEN.WORKSTATION returns a "device handle," a number that 
uniquely identifies the open device. This is used in subsequent calls 
to the device by including it as the first argument in the parameter list. 
For simplicity, this will not be shown explicitly in the following 
pseudocode. } 

for (every grid line) 

begin; 
{ Create an array that contains the points that define a vertical grid line 
in NDC space (beginning and end points of each grid line). The maximum 
extent in each axis is 32767 assuming we opened the device in coordinate 
transformation mode 0. } 

POLYLINE(grid line); 
{ Use POLYLINE to draw the line } 

end; 
SET.ALIGNMENT(top center); 

{ SET.ALIGNMENT changes the text attribute defining how GSS-DRIVERS 
places text with respect to the points specified in following graphics 
output routines. We use this call to center the text below the point 
specified. } 
for (every horizontal axis tick) 

begin; 

GRAPHIC.TEXT(x position.y position,month[i]); 
{ Output the text for the horizontal axis using the default character 
size. Month[i] represents the character string identifying each month. } 

end: 
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SET.ALIGNMENT(right center); 

{ We use SET.ALIGNMENT here to position text's right side center line 
at the graphics text position. } 
for (every vertical axis label) 
begin; 
GRAPHIC.TEXT(x position^ position,ylabel[i]); 

{ Output the text for the vertical axis at the specified points. } 
end; 
SET.ALIGNMENT(bottom left); 

{ Set the alignment point to the lower left of the text string } 
GRAPHIC.TEXT(x position.y position,' As of June 15"); 

{ Write the subtitle out } 
SET.TEXT.HEIGHT(size of title text); 

{ Set the height for the title } 
GRAPHIC.TEXT(x position.y position,' Aurora Processing Plant"); 

{ GRAPHIC.TEXT is used to write out the title text } 
SET.FILL.INTERIOR(hatch patterns); 

{ SET.FILL.INTERIOR is an attribute routine that determines how any area 
is filled. Valid fill types are empty, solid, hatch and pattern. 
Hatch is used to fill the Gantt bars. } 
SET.FILL.STYLE(45% narrow); 

{ Choose 45% narrow shading } 
for (every bar) 
begin; 
BAR(lower left,upper right); 

{ Draw the bars } 
POLYLINE(frame); 

{ Draw the frame around the axis system } 
POLYLINE(border); 

{ Draw the border around the page } 
REQUEST.STRING(2 characters,echo,echo location,input string); 
{ Wait before we close work station so viewer has a chance to see picture 
if output device is a CRT. Program continues when carriage return or at 
least two characters are entered. } 
CLOSE. WORK.STATION ; 

{ Close down workstation } 
end. 

Language-specific code for this example is shown in Appendix A. 
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FIGURE 2-2 Gantt Chart 
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System Architecture 



This part is a description of the architecture of GSS-DRIVERS and 
a summary of the graphics functions available. A detailed listing 
of each graphics call, its arguments and operation is contained in 
the subsequent reference part. 



The Components of GSS-DRIVERS 

GSS-DRIVERS consists of a set of executable device drivers that 
form the interface between the VDI and specific graphics 
peripheral devices. 

It allows your program to access the hardware on the system in a 
standard way, thereby eliminating operating system 
dependencies. This is true of character and file I/O as well as 
graphics functions. Your application programs will be truly 
portable between various systems employing GSS-DRIVERS as 
the graphics subsystem. 

GSS-DRIVERS provides several functions for the graphics 
subsystem: 

a device driver management 

□ coordinate transformation 

n character and file I/O 

a graphics emulation 

a error reporting 

GSS-DRIVERS on UNIX is part of the application and is loaded 
when the application is executed. 
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Device-driver Management 

The UNIX PC software provides drivers for several graphics 
devices. Select how to install the necessary drivers with the 
procedure explained in your AT&T UNIX PC Owner's Guide for 
the Set 1 device drivers, and AT&T UNIX PC GSS-DRIVERS+ 
User's Guide for the optional Set 2 device drivers. 

The device driver file names must be unique, but there are no 
other constraints other than making sure they are descriptive. 
For example, the device driver file name for an AT&T Model 455 
Printer is "att455." 

Under the UNIX operating system, GSS-DRIVERS is part of the 
application and is loaded when the application is executed. 
When GSS-DRIVERS receives a request for a specific device 
driver via an Open Workstation call, it spawns the appropriate 
device driver process. This process will remain available to the 
application until Close Workstation is invoked. 



Coordinate Transformation 

All graphics coordinates are passed to GSS-DRIVERS in 
Normalized Device Coordinates (NDC). Here all locations are 
measured in Cartesian coordinates between and 32767. This 
lets graphics information be passed to all devices in an identical 
way regardless of the device size or coordinate system. 

GSS-DRIVERS uses information returned from the device driver 
when the workstation is opened to transform the normalized 
coordinates into device-specific coordinates (such as raster lines, 
plotter steps, etc.). This frees an application from performing 
any device-dependent transforms. 



Transformation Modes 

There are two user-selectable ways the NDC-to-device coordinate 
transformation can take place. In the first mode the NDC range 
of 0-32767 is mapped to the full extent of the physical display 
surface in each direction. Using this mode insures that all the 
graphics information will appear on the display surface since all 
NDC points are displayable. 
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However, distortion will occur if the display device does not 
map NDC units to equal physical distances in both directions. 
(This happens on devices with non-unity aspect ratios.) A result 
of this situation is squares that turn into rectangles. 

To avoid this distortion, use the second transformation mode. It 
preserves the aspect ratio of the image by mapping NDC units to 
equal physical distances in both directions. To do this, the full 
NDC space is mapped to the longest axis of the device. The 
other axis displays as much of the NDC space as possible, but 
some information at the edges will be lost. Compensation is 
provided for devices with non-square pixels so that circles 
appear as circles and squares look like squares. The application 
program is responsible in this case for sending only displayable 
NDC units to the system (otherwise they will be lost). This can 
result in device- and system-dependencies. However, drivers 
automatically take device dependencies into account when using 
the bar, pie slice, arc and circle GDP's. 

The first mode unburdens the application from doing a specific 
device-dependent transform. The advantage of the second mode 
is that pictures can be easily transported between devices with 
the assumption that a unity (square) aspect ratio is used. 
GSS-DRIVERS will make the adjustment for the actual aspect 
ratio of the display device. 



Character I/O 

Although the VDI standardizes access to graphics facilities, 
various operating systems have different ways to access the ports 
that control graphics peripherals. To insure that graphics 
applications written using GSS-DRIVERS are truly portable, the 
C language bindings include functions that provide a 
standardized way to do character I/O. The character I/O facility 
includes functions to open, initialize and close the I/O system, to 
obtain status, and to read and send characters. Characters can 
be read and written with or without waiting for completion. 
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File I/O 

A system-independent way of accessing files is also needed to 
make applications portable. GSS-DRIVERS provides a generic 
file I/O system based on the UNIX file model. A pointer 
associated with the file indicates the next byte position to be read 
or written. Each operation (read or write) causes the pointer to 
be updated. A seek operation allows the current position in the 
file to be set without reading or writing data. 



Directories and File Names 

All files reside in distinct areas called directories. A particular 
directory is specified by name — a null terminated string of bytes. 
A file is also referred to by name. A fully qualified file name 
consists of a directory name and a file name with a maximum of 
eighty characters. 

Functions are provided to associate a file name with a file 
descriptor — an integer number that uniquely identifies an open 
file. Up to sixteen file descriptors (open files) may exist 
simultaneously. All file operations require a file descriptor to 
identify the object file. A file's descriptor must be obtained 
before any operations can be performed on it. 



Graphics Emulation 

The VDI is a robust standard that incorporates many advanced 
graphics capabilities. Often the capabilities offered by a graphics 
device are only a subset of the total VDI possibilities. To insure 
application portability, some functions that are not supported by 
the device directly are emulated by GSS-DRIVERS. 



Error Reporting 

GSS-DRIVERS functions always return to the caller whether or 
not the requested operation was successful. Each function 
returns an error status that indicates the results of the request. 
However, no errors are displayed by GSS-DRIVERS. The 
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application program is made aware of the condition of the 
graphics subsystem and can take appropriate action without 
losing control of the system. This places a responsibility on the 
application program for checking error status and attempting 
error recovery, or at least informing the user. 

An explanation of the status codes returned is included in the 
detailed descriptions of GSS-DRIVERS functions in the 
subsequent reference part. 
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Error Codes 

If a function returns an error status, the Inquire VDI Error 
function can be invoked to obtain the applicable error code. 
Messages associated with each error value are provided in 
Appendix B, "Error Codes." Error codes are organized into 
generic and system-dependent information based on the 
following rules: 

a A negative return from a function always implies an error 

a An error code greater than or equal to zero indicates no error 
occurred 

□ The generic part of the code is in the form "GGxx" (in 
decimal) 

□ The system-dependent part is always in the form "xxDD" (in 
decimal). 
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Installation and Operation 



This part describes how to install GSS-DRIVERS on the UNIX 
PC. This part also discusses how to link your application 
programs with the GSS-DRIVERS application library. 



Overview 

The GSS-DRIVERS installation procedure requires you to define 
the following system environmentals: 

□ Set the default directory for the device driver files to be used 
by GSS-DRIVERS 

□ Select which device drivers correspond to logical device names 

□ Assign logical graphics devices to physical channels 

Once these environmentals are defined, you can incorporate 
graphics operations into your application programs by calling 
GSS-DRIVERS functions in your source code. The operations 
and parameters for all GSS-DRIVERS graphic functions are 
detailed in Part 5. These are referred to as the language 
"bindings" because they show explicitly how GSS-DRIVERS 
interfaces to the C programming language. The bindings for the 
character and file I/O functions are also provided. 



Distribution Files 

GSS-DRIVERS distribution files contain the C language bindings 
library, a header include file, and test files. 

libcvdi.a C language binding library. 

types. h Header include file. 

vditest Test programs that verify proper operation. Both the 
source and the executable files are included. 
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Installing the VDI Software 

This section contains a guide to installing the software for the 
AT&T UNIX PC Virtual Device Interface C Binding. Depending 
upon the version of the operating system being used, some 
procedures and screen displays may vary from those shown 
here. Typical variations in the procedure are addressed within 
this guide, although others may exist. 

Before you begin the installation procedure, locate the following 
floppy disk: 

GSS-DRIVERS C Binding Version 1.01 

1 When prompted by Please login: 

n Type your user login or you can type install. 



□ Press (Enter) . 

If a password is required for system access, the Password: 
prompt will appear and you must continue with the 
following instructions. Otherwise proceed with the 
instructions in step 2. 

n Type the password exactly as it was defined to the 

system. As a security measure, the password will not be 
displayed on the screen when it is typed. 



□ Press (Enter) . 

The system briefly displays a message that shows the 
amount of available storage space. 

If there is less than 15% of the storage space available, you 
may want to choose one of the following options: 

— Delete unnecessary files from the Wastebasket. 

— Backup files from the hard disk onto floppy disks and 
delete these files from the hard disk. 

— Remove software that is no longer required. 

See the AT&T UNIX PC Owner's Manual for details on 
performing these operations. 
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After a few seconds, the system displays the following 
Office Window with the Administration selection highlighted. 
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□ Press (Enter) . 
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The system displays the Administration Window. 
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□ Press (Next) until you have highlighted Software Setup. 
n Press (Enter) . 
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The System displays the Software Window with the Install 
Software from Floppy selection highlighted. 
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□ Press (Enter) . 
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6 At this point, depending upon the version of the operating 
system being used, the system may display the Install 
Window with the cursor positioned at the prompt Number of 
diskettes: as shown below. If so, continue with the following 
instructions. Otherwise, proceed with the instructions in 
step 7. 




Type nunber of floppy diskettes to be installed. 

□ Enter 1 for the number of diskettes that are to be 
installed. 

□ Press (Enter) . 
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7 The system displays the Confirm Window with the 

following message or a similar message instructing you to 
insert the diskette: 




□ Insert the GSS-DRIVERS C Binding Version 1.01 into 
the diskette drive with the label facing up. 

□ Close the drive by flipping the lever down. 



□ Press (Enter) . 

Note 

If an error message appears on the screen during 
installation, check that the diskette is in good working 
condition and inserted correctly in the drive. 
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Depending upon the version of the operating system being 
used, the system may display the Confirm Window with the 
Install In progress message as shown below. If so, continue 
with the following instructions. Otherwise, a screen 
message informs you of the storage space available on your 
system and offers you the opportunity to continue by 
pressing (Enter) or to cancel the installation by pressing 
(Cancl) . If not enough space is available, see the options 
listed under step 2. 
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Do not open the diskette drive until it is safe or data can 
be lost or destroyed. 
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9 When the installation is complete, the system displays the 
following message: 

The installation of the GSS-DRIVERS C 
C Language Binding Version 1.01 package 
is now complete. 

Please press Enter to continue. 

□ Press (Enter) as indicated on the screen. 

10 The system removes the Confirm Window from the screen 
and displays the Software Window. It is now safe to 
remove the floppy diskette. 

a Open the drive by flipping the drive lever up. 

□ Remove the diskette. 

a Press (Exit) to return to the Administration Window. 

□ Press (Exit) again to return to the Office Window. 
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Setting the Environment 

There are several environmental variables that should be set 
before running your application. Since there is a possibility that 
several drivers may be resident on your UNIX PC for that device 
type, you must indicate which driver should be used by 
GSS-DRIVERS functions. When v_opnwk (Open Workstation) is 
called, you specify a logical device name such as PRINTER, 
PLOTTER, DISPLAY, etc. The v_opnwk then searches the 
environment for a variable by the same name as the device. This 
variable holds the file name of the driver. 

You must also specify which physical device a driver is to use. 
This is accomplished by setting an environmental variable with 
the same name as the device driver, containing the name of the 
physical device. The variable VDIPATH holds the appropriate 
pathname for GSS-DRIVERS. 

These assignments can be made through the "GSS-Drivers 
Setup" menu. They are inserted in the environment by 
executing the file 

/usr/lib/GSS_Drivers/Environment 

If the GSS-DRIVERS pathname is not provided, the current 
working directory is used. 

The default output metafile name is metafile. met. This can be 
changed with the following commands: 

METAOUTPUT= <filename> 
export METAOUTPUT 

where <filename> is the name to be used for subsequently 
created metafiles. 
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Linking Applications 

The code that implements the interface between GSS-DRIVERS 
and your programming language is contained in the libcvdi.a 
binding library included on the distribution diskette. After your 
program is compiled, it must be linked with this binding library 
and other modules and libraries required by the application. In 
general, the binding should be linked after your application code 
and before any language support libraries. 

The C language binding library, libcvdi.a, is located in the 
system library directory: 

/usr/lib/libcvdi.a 

It can be accessed from any directory by the command: 

cc picture. c -Icvdi -Itam -Itermcap -o picture 

The option -lcvdi is an abbreviation for /usr/lib/libcvdi.a. It 
informs the linker that a library called /usr/lib/libcvdi.a is 
required. 

Note 

The -1 switch can be used to associate an argument with an exact 
library file within /usr/lib. The linker will look for the file name 
that begins with "lib" and ends with the string that follows the -1 
switch. For example, -ltester would be the library 
/usr/lib/libtester.a, and -lm would be the library /usr/lib/libm.a, 
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Testing the System 

The test programs provided in the distribution files can be used 
to verify that the configuration shell script is correct and that 
your application is properly linked. If the test programs do not 
execute successfully, retrace your installation steps to discover 
the source of the error. Make sure that you have made the 
appropriate physical device (port) assignment and baud rate 
selection by exercising your peripherals with previously 
operating programs. 

The executable program module is executed and debugged in the 
normal manner using the tools provided by the operating system 
environment. Since GSS-DRIVERS functions always return to 
the calling program with status information rather than 
displaying error messages, we recommend that you include a 
very simple status checking routine in your program that is 
called after each graphics function. Its purpose is to display any 
error codes that arise before you have finished debugging your 
application error handling routines. 
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Height 5-97 

vst_rotation () 5-98 
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vrd_curkeys () 
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vrq_choice () 


5-103 


vrq_locator () 
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vrq_string () 
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vrq_valuator () 
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vsm_choice () 
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vsm_locator () 
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vsm_string () 
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vsm_valuator () 
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Inquiry Functions 
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vq_cellarray () 


5-117 


vq_chcells () 
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vq_color () 
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vq_curaddress () 
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vq_error 


5-122 


vqa_cap () 


5-123 


vqa_cell () 
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vqa_font () 


5-128 


vqa_length () 


5-131 


vqa_position () 
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vqf_attributes () 
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vql_attributes () 
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vqm_attributes () 


5-135 


vqt_attributes () 
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Communications (Port) I/O 5-140 

Disk I/O 5-141 

cm_close () 5-143 

cm_inq () 5-144 



cm_open () 5-145 

cm_start 5-146 

cm_stop 5-147 

cmrx_now () 5-148 

cmrx_wait () 5-149 

cmtx_now () 5-150 

cmtx_wait () 5-151 

fd_close() 5-152 

fd_connect () 5-153 

fd_copy () 5-154 

fd_delete() 5-155 

fd_directory () 5-156 

fd_disconnect () 5-157 

fd_inq() 5-158 

fd_open () 5-159 

fd.parse () 5-160 

fd_read() 5-161 

fd.rename () 5-162 

fd_seek() 5-163 

fd_size(fd) 5-164 

fd_write () 5-165 

fdp_read() 5-166 

fdp_write () 5-167 
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This section covers the control functions provided by 
GSS-DRIVERS that allow: 

□ initialization and termination 

□ device control 

□ workstation control 

□ cursor control 



Initialization and Termination 

When you initialize GSS-DRIVERS, default values are set for all 
attributes and the device capabilities are determined. When you 
terminate the program, control returns to the keyboard. Open 
Workstation must be the first routine called and Close 
Workstation, the last. 



Device Control 

For ultimate device control, GSS-DRIVERS allows you to set the 
pen speed on a plotter, set the raster writing mode and generate 
hard copy. 



Workstation Control 



Control functions are also provided that allow you to update a 
workstation by making all output current and to clear the 
workstation. 
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Cursor Control 

You will remember from the Graphics Model discussed in Part 2 
that GSS-DRIVERS supplies three types of text: 

a Alpha Text used for creating word processor quality text on 
CRTs or printers 

□ Cursor Text used primarily for creating forms 

a Graphics Text. 

To control both Alpha and Graphics Text, you must be in the 
Graphics Mode. 

To control the cursor for cursor text you must be in the Cursor 
Addressing Mode. This gives you access to functions that are 
used for positioning the standard CRT cursor and placing text on 
the screen. 

Note 

Cursor addressing only applies to CRT devices. 

Cursor addressing is defined on a character cell grid of rows and 
columns. Rows are the number of lines of text on the screen, 
and columns are the number of character cells per line. The 
upper left corner of the screen is row 1, column 1. Typical 
screen formats are 24 rows by 80 columns. 
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Metafile VDI Functions 

Two special VDI functions are available in GSS-DRIVERS for use 
with metafiles. The Message function allows message text that is 
not part of a picture to be placed in the metafile. This text is 
simply passed on to the metafile interpreter and displayed to the 
operator at interpretation time. It is intended to permit the 
display of special device-dependent information needed to 
process a VDM. There is no control over the position or 
appearance of the text. 

The Application Data function allows an application program to 
store and access private data in a metafile. When retrieved, this 
data is not processed in any way by the metafile interpreter, but 
is available to the application. 



A Note on Binding Conventions 

In the C bindings, INT16 refers to signed 16-bit integers and 
INT8 refers to signed 8-bit integers. FD refers to a signed 16-bit 
integer. INT32 refers to a long integer (32 bit). Scalar input 
arguments are passed by value, array input arguments are 
passed by address. All output arguments are passed by address. 
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TABLE 5-1 Control Functions 






Function 


Routine 


Description 


Page 


Initialization 


v_opnwk 


Open Workstation 


5-20 


Termination 


v_clswk 


Close Workstation 


5-7 


Device Control 


v_hardcopy 


Hard copy 


5-18 




vs_penspeed 


Set Pen Speed 


5-33 




vswr_mode 


Set Writing Mode 


5-35 


Workstation 


v_clrwk 


Clear Workstation 


5-6 


Control 


v_updwk 


Update Workstation 


5-31 


Alpha Text 


vsa_position 


Set Alpha Text 


5-34 


Control 




Position 




Cursor Text 


v_enter_cur 


Enter Cursor 


5-16 


Control 




Addressing Mode 






v_curup 


Cursor Up 


5-12 




v_curdown 


Cursor Down 


5-8 




v_curright 


Cursor Right 


5-11 




v_curleft 


Cursor Left 


5-10 




v_curhome 


Cursor Home 


5-9 




v_eeol 


Erase to End 
of Line 


5-14 




v_eeos 


Erase to End 
of Screen 


5-15 




vs_curaddress 


Direct Cursor 
Address 


5-32 




v_exit_cur 


Exit Cursor 
Addressing Mode 


5-17 


Graphics Cursor 


v_dspcur 


Display Graphics 


5-13 


Control 




Input Cursor 






v_rmcur 


Remove Graphics 
Input Cursor 


5-30 


Metafile 


v_appl 


Application Data 


5-5 




v_msg 


Message 


5-19 
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v_appl () 



Purpose 
Syntax 
Data Types 



Input 



Function 
Returns 



Description 



Metafile application data 

v_appl (dev_handle, function, data cnt, app data) 

INT16 v_appl 0; 
INT16 dev_handle; 
INT8 function[ ]; 
INT16 data_cnt; 
INT16app_data[]; 

dev_handle 

Metafile device handle 

function 

Text string indicating function name 

data_cnt 

Number of integers of application data 

app_data 

Name of array containing application data 

Function v_appl returns error state. 
if no error 
-1 if error 
Actual error can be retrieved by invoking error 
inquiry function. 

This routine allows the metafile generator to place 
application specific data into the metafile. The 
function name is a user-defined title for whatever 
the application data element represents. 
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v_clrwk () 



Purpose Clear workstation 

Syntax v_clrwk (devjiandle) 

Data Types INT16 v_clrwk (); 
INT16 devjiandle; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_clrwk returns error state. 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine clears CRT screens, prompts for new 
paper on plotters, or displays all pending graphics 
and advances to top-of-form on printers. 

Often, this call is preceded by an input routine 
when using a CRT so that output will not be 
cleared from the screen before the user has a 
chance to view the image. Prompts can be 
controlled by Open Workstation. 
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v_clswk () 



Purpose Close workstation 

Syntax v_clswk (devjiandle) 

Data Types INT16 v_clswk (); 
INT16 devjiandle; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_clswk returns error state. 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine displays any pending graphics, then 
stops all graphics output to the specified 
workstation. It must be called to terminate a 
program and should be the last graphics routine 
called. 
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v_curdown () 



Purpose Cursor down 

Syntax v_curdown (devjiandle) 

Data Types INT16 v_curdown (); 
INT16 devjiandle; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_curdown returns error state. 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description When you are in Cursor Addressing Mode, this 
routine moves the cursor down one row without 
altering its horizontal position. If the cursor is 
already at the bottom margin, the screen will scroll 
up one line. When the cursor is on the bottom 
line of the screen and characters are subsequently 
sent to the screen, any characters which exceed 
the right margin will wrap around to the left 
margin. Any characters already on the last line 
will be overwritten. This function is only 
applicable to CRT devices. 
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v_curhome () 



Purpose Cursor home 

Syntax v_curhome (dev_handle) 

Data Types INT16 v_curhome (); 
INT16 dev_handle; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_curhome returns error state. 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description When you are in Cursor Addressing Mode, this 
routine moves the cursor to the home position 
(upper left corner of the screen). It is only 
applicable to CRT devices. 
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v_curleft () 



Purpose Cursor left 

Syntax v_curleft (devjiandle) 

Data Types INT16 v_curleft (); 
INT16 dev_handle; 

Input devjhandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_curleft returns error state. 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description When you are in Cursor Addressing Mode, this 
routine moves the cursor left one column without 
altering its vertical position. No action occurs if 
the cursor is already at left margin. This function 
is only applicable to CRT devices. 
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v_curright () 



Purpose Cursor right 

Syntax v_curright (devjiandle) 

Data Types INT16 v_curright (); 
INT16 dev_handle; 

Input devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_curright returns error state. 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description When you are in Cursor Addressing Mode, this 
routine moves the cursor right one column 
without altering its vertical position. No action 
occurs if the cursor is already at right margin. 
This function is only applicable to CRT devices. 
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v_curup () 



Purpose Cursor up 

Syntax v_curup (devjiandle) 

Data Types INT16 v_curup (); 
INT16 dev_handle; 

Input devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_curup returns error state. 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description When you are in Cursor Addressing Mode, this 
routine moves the cursor up one row without 
altering its horizontal position. No action occurs if 
the cursor is already at the top margin. This 
function is only applicable to CRT devices. 
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v_dspcur () 

Purpose Display graphics input cursor 

Syntax v_dspcur (dev_handle, x, y) 

Data Types INT16 v_dspcur (); 
INT16 dev_handle; 
INT16 x,y; 

Input devjhandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

x 

x-coordinate of location to place cursor. 



Function 
Returns 



Description 



y-coordinate of location to place cursor. 

Function v_dspcur returns error state 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq„error. 

When you have exited Cursor Addressing Mode, 
this routine displays a graphics input cursor 
centered about the specified location. The 
graphics cursor is the same as the one used for 
feedback by the Input Locator function (crosshairs, 
arrow, etc.). The Input Locator function will 
automatically display a cursor when needed. This 
function does not need to be referenced when 
using Input Locator. It is only applicable to CRT 
devices. 
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v_eeol 



Purpose Erase to end of line 

Syntax v_eeol (dev_handle) 

Data Types INT16 v_eeol (); 

INT16 dev_handle; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_eeol returns error state 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description When you are in Cursor Addressing Mode, this 
routine erases from the current cursor position to 
the end of the line. It is only applicable to CRT 
devices. 
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v_eeos () 



Purpose Erase to end of screen 

Syntax v_eeos (devjiandle) 

Data Types INT16 v_eeos (); 
INT16 dev_handle; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_eeos returns error state 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description When you are in Cursor Addressing Mode, this 
routine erases from the current cursor to the end 
of the screen. It is only applicable to CRT devices. 
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v_enter_cur () 



Purpose Enter cursor addressing mode 

Syntax v_enter_cur (devjiandle) 

Data Types INT16 v_enter_cur (); 
INT16 dev_handle; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_enter_cur returns error state 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine exits Graphics Mode if different from 
Cursor Addressing Mode. 

It must precede all other cursor addressing 
functions, such as Cursor Up, etc. This routine 
"homes" the cursor. 

Cursor addressing is only meaningful on CRT 
devices. It is defined on a character cell grid of 
rows and columns (rows equals the number of 
lines on a screen, and columns equals the number 
of character cells per line). The upper left-hand 
corner of the screen is row 1, column 1. 
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v_exit_cur () 



Purpose Exit cursor addressing mode 

Syntax v_exit_cur (dev_handle) 

Data Types INT16 v_exit_cur (); 
INT16 dev_handle; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_exit_cur returns error state. 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine exits Cursor Addressing Mode if 

different from Graphics Mode. For applications to 
work properly, this function must be used to enter 
Graphics Mode from Cursor Addressing Mode. 
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v_hardcopy () 



Purpose Hardcopy 

Syntax v_hardcopy (devjiandle) 

Data Types INT16 vjiardcopy (); 
INT16 dev_handle; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function vjiardcopy returns error state 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine generates a hard copy. It is very 
device-specific and may involve copying the 
screen to a printer (doing a "screen dump") or 
other attached hard copy device. 
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v_msg 

Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Metafile message 

v_msg (dev_handle, message, wait) 

INT16 v_msg (); 
INT16 devjiandle; 
INT8 message[]; 
INT16 wait; 

dev_handle 

Metafile device handle. 

message 

Text string. 

wait 

Pause indicator. 

= if no response required 

1 = if pause after issuing message and 

wait for a response. 

Function v_msg returns error state. 
if no error 
-1 if error 
Actual error can be retrieved by invoking error 
inquiry function. 

This function places a text string in the metafile 
which will be displayed by the interpreter as an 
operator message. It appears on the console in a 
device-dependent position. 

The pause indicator controls whether the 
interpreter will pause for a (device-dependent) 
response or continue. 
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v_opnwk () 

Purpose Open workstation 

Syntax v_opnwk (work_in, &dev_.handle, work_out) 

Data Types INT16 v_opnwk (); 
INT16 work_in[19]; 
INT16 dev_handle; 
INT16 work_out[66]; 

Input work_in[0] 

Coordinate transformation mode flag. 

Determines how to transform NDC space to device 

coordinate. 

= Map NDC space to full extent of each axis. 

This mode does not preserve aspect ratio. 
Picture will completely fill screen. 

1 = Map NDC space to full extent of longest 

axis only; map subset of NDC space to 
shorter axis. This mode preserves unity 
aspect ratio. Using this technique and 
the appropriate scaling factor results in 
a picture with the same aspect ratio. 

work_in[l] 

Polyline line type. 

work_in[2] 

Polyline color index. 

work_in[3] 

Polymarker type. 

work_in[4] 

Polymarker color index. 

work_in[5] 

Graphics text font. 

work_in[6] 

Graphics text color index. 

work_in[7] 

Fill interior style. 

work_in[8] 

Fill style index. 
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work_in[9] 

Fill color index. 

work_in[10] 

Prompting flag for controlling screen prompts. 
Typical prompts are for paper and pen changes 
on plotters. 

= Do not display device-dependent prompts 

to the logical message device 

1 = Display device-dependent prompts to the 

logical message device 

work_in[ll-18] 

Workstation identifier (device driver logical name). 
This is an ADE form that is used to determine 
which driver to dynamically bring into memory, 
but is not used by the driver itself. The following 
names should be used for logical device names 
unless they are superseded by an environment 
variable: DISPLAY, PLOTTER, PRINTER, 
METAFIL, CAMERA, JOYSTIK, MOUSE, 
GRAFOUT, GRAFIN. 

Output devjhandle 

Device handle associated with the workstation 
identifier. (workin_[ll-18j) 

work_out[0] 

Maximum addressable width of screen/plotter in 
rasters/steps assuming a start point (e.g. a 
resolution of 640 implies an addressable area of 
0-639, so work_out[0]=639) 

work_out[l] 

Maximum addressable height of screen/plotter in 
rasters/steps assuming a start point (e.g. a 
resolution of 480 implies an addressable area of 
0-479, sowork_out[l]=479) 

work_out[2] 

Device coordinate units flag. 

= Device capable of producing precisely 

scaled image (typically plotters and 
printers) 

1 = Device not capable of precisely scaled 

image (CRTs) 
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work_out[3] 

Width of one pixel (plotter step) in micrometers. 

work_out[4] 

Height of one pixel (plotter step) in micrometers. 

work_out[5] 

Number of character heights. 
= continuous scaling 

work_out[6] 

Number of line types. 

= device is not capable of graphics 

work_out[7] 

Number of line widths. 

work_out[8] 

Number of marker types. 

work_out[9] 

Number of marker sizes. 
= continuous scaling 

work_out[10] 

Number of graphics text fonts. 

work_out[ll] 

Number of patterns. 

work_out[12] 

Number of hatch styles. 

work_out[13] 

Number of predefined colors. 
This is the number of colors that can be displayed 
on the device simultaneously when in Graphics 
Mode. The number of colors in Cursor 
Addressing Mode may be different. 

Note 

There must be at least two colors, even for 
monochrome devices. 

work_out[14] 

Number of Generalized Drawing Primitives (GDP). 
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work_out[15-24] 

List of available GDPs. (Up to ten allowed) 

1 = bar 

2 = arc 

3 = pie slice 

4 = circle 

-1 = GDP does not exist 
The list can be specified in any order. 

work_out[25-34] 

Attribute set associated with each GDP. 
-1 = GDP does not exist 

= Polyline 

1 = Polymarker 

2 = Text 

3 = Fill area 

4 = None 

5 = Other 

work_out[35] 

Color capability flag. 

= no 

1 = yes 

work_out[36] 

Text rotation capability flag. 

= no 

1 = yes 

work_out[37] 

Fill area capability flag. 

= no 

1 = yes 

work_out[38] 

Pixel operation capability flag 

= no 

1 = yes 

work_out[39] 

Number of available colors. 
Total number of colors in color palette. 
= Continuous device 

2 = Monochrome (black and white) 
>2 = Number of colors available 
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work_out[40] 
Locator capability flag. 

= no 

1 = yes 

work_out[41] 

Valuator capability flag. 

= no 

1 = yes 

work_out[42] 

Choice capability flag. 

The value returned is the number of CHOICE 
indicators available. For example, if five function 
keys are used as CHOICE devices, the value 
returned would be 5. 

work_out[43] 

String input capability flag. 

= no 

1 = yes 

work_out[44] 

Workstation type. 

= Output only 

1 = Input only 

2 = Input/Output 

3 = Device-independent segment storage 

4 = Metafile output 

5 = Other 

work_out[45] 

Device type. 

= CRT 

1 = Plotter 

2 = Printer 

3 = Camera/film recorder 

4 = Metafile output 

5 = Other 

work_out[46] 

Number of writing modes available. 
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work_out[47] 

Highest level of input mode available. 

= none 

1 = request 

2 = sample 

work_out[48] 

Text alignment capability flag. 

= no 

1 = yes 

work_out[49] 

Inking capability flag as output echo device. 

= no 

1 = yes 

work_out[50] 

Rubberbanding capability flag as output echo device. 

= No rubberband capability 

1 = Capable of rubberband lines 

2 = Capable of rubberband lines and rectangles 

work_out[51] 

Maximum addressable NDC space coordinate on 
x-axis. This value is filled in based on the coordinate 
transformation mode selected. 

work_out[52] 

Maximum addressable NDC space coordinate on 
y-axis. This value is filled in based on the coordinate 
transformation mode selected. 

work_out[53-57] 
Version of the driver. 

This is an ADE character string that represents the 
version of the driver in the following form: 
w.ll 

where vv is the actual version 

and 11 is the level. 

work_out[58-59] 

Reserved for future use. 

work_out[60] 

Minimum graphics character height in NDC units. 

work_out[61] 

Maximum graphics character height in NDC units. 
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Function 
Returns 



Description 



work_out[62] 

Minimum line width in NDC units. 

work_out[63] 

Maximum line width in NDC units. 

work_out[64] 

Minimum marker height in NDC units. 

work_out[65] 

Maximum marker height in NDC units. 

Function v_opnwk returns error state. 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine initializes a workstation (a graphics 
device). It sets all defaults and returns device 
information. Both the alpha and graphics display 
surfaces are cleared by this function. 



Color Indices 

The following lists are the color index values for the Open 
Workstation routine. 

Monochrome Devices Index 

= Black for CRTs & White for printers/plotters 

1 = White for CRTs & Black for printers/ plotters 

Color Devices Index 

= Black for CRTs & White for printers/ plotters 

1 = White for CRTs & Black for printers/ plotters 

2 = Red 

3 = Green 

4 = Blue 

5 = Yellow 

6 — Cyan 

7 = Magenta 

8-n = Device-dependent 
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Opening an Output Device 

Each time v_opnwk is invoked to open an output device, the 
values specified in the input array, work_in, are implemented. 
In addition, the following default values take effect: 

Graphics character height = largest size that allows 80 characters 

horizontally and 24 characters vertically 
Character baseline rotation = degrees rotation 
Line width = 1 device unit (raster, plotter step) 
Marker height = minimum marker height 
Writing mode = 4 (replace) 
Input mode = request for all input classes (locator, valuator, 

choice, string) 
Text alignment = bottom for vertical alignment; left for 

horizontal alignment 
Cursor addressing mode = off 
Alpha text position = uppermost left corner of display surface to 

allow for one default alpha text character to appear but not 

be off the display surface 
Alpha text line spacing = single spacing 
Alpha text font = standard font that has 80 characters 

horizontally across the display surface 
Alpha text subscripting and superscripting = off 
Alpha text underlining = off 
Alpha text overstriking = off 
Alpha text pass through = off 
Alpha text quality = high quality 
Alpha text color index = 1 
Line delete character = 'U (NAK) 
Char delete character = A H (Backspace) 



Opening an Input Device 

When Open Workstation (v_opnwk) is called to open an input 
device, the input array (workjn) is implemented as follows: 
work_in[0], the coordinate transformation mode flag, specifies 
which aspect ratio to use. If O is chosen for this flag for both the 
input device and the output echo device, the full extents of the 
graphics input device will map to the full extents of the output 
echo device when echoing input. If 1 is chosen for the flag for 
either the input device or the output echo device, the full extents 

Control Functions 5-27 



of the two devices may not be the same. For example, the two 
devices could possibly overlap. 

work_in[l] to work_in[10] are not applicable for an input device 
work_in[ll] to work_in[18] specify the logical name to be used to 
refer to the device. 

The output array (work_out) for a typical input device would 
contain the following elements: 

work_out[0], the addressable width of input device in rasters = 

Device-dependent value 
work_out[l], the addressable height of input device in rasters = 

Device-dependent value 
work_out[2], device coordinates in raster units flag = 1 
work_out[3], width of a pixel in micrometers = 

Device-dependent value 
work_out[4], height of a pixel in micrometers = 

Device-dependent value 
work_out[5], number of character heights = 
work_out[6], number of line types = 
work_out[7], number of line widths = 
work_out[8], number of marker types = 
work_out[9], number of marker sizes = 
work_out[10], number of graphics fonts = 
work_out[ll], number of patterns = 
work_out[12], number of hatch styles = 
work_out[13], number of predefined colors = 
work_out[14], number of GDPs = 
work_out[15] to work_out[34], no GDPs or associated bundle 

tables available = -1 
work_out[35], color capability flag = 
work_out[36], text rotation capability flag = 
work_out[37], fill area capability flag = 
work_out[38], pixel operation capability flag = 
work_out[39], number of available colors = 
work_out[40], locator capability flag = 1 
work_out[41], valuator capability flag = 
work_out[42], number of choices devices available = 
work_out[43], string input capability flag = 
work_out[44], workstation type = 1 
work_out[45], device type is other = 5 
work_out[46], number of writing modes available = 
work_out[47], highest level of input mode available — request = 1 
work_out[48], text alignment capability flag = 
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work, 
work, 
work, 
work, 
work, 
work, 
work, 
work, 
work, 
work, 
work, 
work, 
work 



out[49 
.out[50 
.out[51 
put[52 
.out[53 
out[58 
.out[59 
.out[60 
put[61 
.out[62 
.out[63 
.out[64 
out[65 



, inking capability flag = 
, rubberbanding capability flag = 
, max x in NDC = Device-dependent value 
, max y in NDC = Device-dependent value 
to work_out[57], Version of driver = 2.00 
, reserved = 
, reserved = 

, minimum character height in NDC space -= 
, maximum character height in NDC space - 
, minimum line width in NDC space = 
, maximum line width in NDC units = 
, minimum marker height in NDC units ~ 
, maximum marker height in NDC units -- 



Code Example — Open Workstation 

The following program is a code example for the v_opnwk (Open 
Workstation) function: 

static int16 nominate!] = (1, /* coordinate transformation mode, 
mode is to map chart to entire display surface, 
mode 1 is to map 32767 to longest axis */ 

1 , /* line type 1o use, 1 indicates solid */ 

1 , /* line color index to use */ 

3, /* marker type, 3 is a star */ 

1 , /* marker color index */ 

1 , /* text font to use */ 

1 , /* text color */ 

0, /* fill interior style, indicates hollow */ 

0, /* fill style index */ 

1, /* fill color index */ 

1, /* device messages to screen */ 
'D','r,'S','P','L','A','Y',' 7* device name to use*/ 
} 

int16 device_info[66], devicejiandle, err_report, xscale, yscale, scale; 
err_report = v_opnwk (nominate, &device_handle, devicejnfo); 
/* Using the aspect ratio returned from the GSS VDI, 
determine the scaling in the x direction */ 
xscale = device_info[51] / 300; 

/* Using the aspect ratio returned from the GSS VDI, determine 
the scaling in the y direction */ 
yscale = device_info[52] / 200; 

/* determine the smaller of the two scaling factors and use it 
for transformation from user units (300 cm by 200 cm) to 
normalized device coordinates */ 
scale = (xscale > yscale) ? yscale : xscale; 
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v_rmcur () 



Purpose Remove graphics input cursor 

Syntax vjrmcur (dev_handle) 

Data Types INT16 v_rmcur (); 
INT16 dev_handle; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_rmcur returns error state. 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine removes the graphics input cursor 

from its current location on the screen. It does not 
need to be referenced for performing Locator 
Input. 
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v_updwk () 



Purpose Update workstation 

Syntax v_updwk (dev_handle) 

Data Types INT16 v_updwk (); 
INT16 devjiandle; 

Input devjhandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_updwk returns error state. 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine displays all pending graphics on the 
workstation. For printers, this causes the current 
picture to be output and the printer to advance to 
top-of-form. 
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vs_curaddress () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Direct cursor address 

vs_curaddress (devjiandle, row, column) 

INT16 vs_curaddress (); 
INT16 dev_handle; 
INT16 row; 
INT16 column; 

devjhandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

row 

Row number. 

1 to number of rows 

column 

Column number. 

1 to number of columns 

Function vs_curaddress returns error state. 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

When you are in Cursor Addressing Mode, this 
routine moves the cursor to a specified position. 
The position is specified in cursor space with row 
1 column 1 being the top left corner of the screen. 
If you specify a position off the screen, the cursor 
will not move. It is only applicable to CRT 
devices. 
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vs_penspeed () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set pen speed 

vs_penspeed (dev_handle, speed) 

INT16 vs_penspeed (); 
INT16 devjiandle; 
INT16 speed; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

speed 

Pen speed as percentage of maximum speed. 
to 100 

Function vs_penspeed returns 
>0 if pen speed 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the plotter pen speed to a 
percentage of the maximum speed between and 
100; it only affects plotter devices. 

This call can be used to slow down a plotter when 
using nonstandard inks or media. 
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vsa_position () 



Purpose 
Syntax 
Data Types 



Input 



Output 



Function 
Returns 



Description 



Set alpha text position 

vsa_position (dev_handle, x_in, y_in, &x_out, &y_out) 

INT16 vsa„position (); 
INT16 devjiandle; 
INT16 x_in; 
INT16y_in; 
INT16x_out; 
INT16 y_out; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

x_in 

x-coordinate of text position in NDC units. 

y_in 

y-coordinate of text position in NDC units. 

x_out 

x-coordinate of text position selected in NDC units. 

y_out 

y-coordinate of text position selected in NDC units. 

Function vsa_position returns 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

When you have exited Cursor Addressing Mode, 
this routine sets the alpha text position to the 
location specified. This specifies the position of the 
lower left-hand corner of the alpha text string. It 
is assumed that (0,0) is at the lower left-hand 
corner of the display surface. The alpha position 
is updated only when the position is set or when 
the Output Alpha Text function is invoked. If the 
position is set at the maximum x or y extent, 
display of alpha text is device-dependent since 
characters positioned at that point would be off 
the display surface. 
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vswr_mode () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set writing mode 

vswr_mode (dev_handle, modejn) 

INT16 vswr_mode (); 
INT16 devjiandle; 
INT16 modejn; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

mode_in 

Writing mode requested. 

Key: s = color index of source pixel 

d = color index of destination pixel 

1-d = (all bits of color index off) 

2-d = d and s 

3-d = (not d) and s 

4-d = s 

5-d = d and (not s) 

6-d = d 

7-d = d xor s 

8-d = d or s 

9-d = not (d or s) 
10-d = not (d xor s) 
11-d = not d 
12-d = (not d) or s 
13-d = not s (reverse video) 
14-d = d or (not s) 
15-d = not (d and s) 
16-d = all bits of color index on 

Function vswr_mode returns 
> if mode selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the current writing mode. It 
specifies the Boolean operation that is performed 
between the color indices of the source and 
destination pixels when lines, text, filled areas, 
etc. are placed on the display. Mode 4 "replace" 
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is the default for printers and screen devices. 
Mode 8, "overstrike" is the default for plotters. 

This function refers only to Graphics Mode, and 
does not affect cursor text. 

Writing modes will work on the printers in a 
manner similar to screen device operation. If two 
objects are displayed on top of each other, the 
result will be determined by the current writing 
mode. 
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Output Functions 



This section covers the output functions that allow you to 
describe objects in Normalized Device Coordinates. They 
provide the capabilities to: 

□ place polymarkers 

□ display alpha, cursor and graphics text 
a fill a defined area 

□ output a cell array 

a draw special geometric primitives such as bars, circles, 
and arcs. 



Primitive Functions 

The graphical world that the programmer describes to the system 
consists of one or more objects. Each graphical object is 
described, in turn, by output primitives which have specific 
attributes. 



Polyline Function 

The polyline is the fundamental line drawing primitive and 
generates a set of connected lines given an array of points as a 
parameter. Since polyline is the basic primitive, attributes such 
as line color or line style apply to the complete polyline rather 
than to a segment. 
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Polymarker Function 

Markers are special symbols that can be placed on the display 
surface to provide a method for identifying two-dimensional 
positions on the output display surface. The basic primitive is a 
polymarker that outputs a sequence of markers, each centered on 
a specified position. 



Text Function 

The text primitives display a string of either alpha, cursor or 
graphics text characters at a specified location. 



Fill Area Function 

This primitive defines the boundary of a polyline that can be 
hollow, filled in solidly or filled with either a pixel pattern or a 
hatching pattern. 



Cell Array Function 

The cell array function provides a means of specifying an array of 
colors or intensities. This is particularly useful in image 
processing applications. 



Generalized Drawing Primitives 

GSS-DRIVERS also supports special geometric primitives. 

Bars Bars are a special type Of filled area defined by 

opposite corners, so filled area attributes affect their 
appearance. Bars can be displayed with control over 
the interior style (HOLLOW, SOLID, PATTERN, 
HATCH), fill style (type of pattern or hatch) and 
color. 



5-38 Control Functions 



Circles Circles are also a special type of filled area defined 
by a center point and radius, so filled area attributes 
affect their appearance. They too can be displayed 
with control over the interior style and fill style. 

Pie Slices Pie slices are a special type of filled area defined by a 
center point and the two points of the arc. Like bars 
and circles, they are affected by filled area attributes, 
including interior and fill style. 

Arcs Arcs are a special type of polyline defined by a center 

point and the two end points of the arc. They are 
affected by the polyline attributes of color, line style 
and line width. 



TABLE 5-2 Output Functions 






Function 


Routine 


Description 


Page 


Polyline 


v_pline 


Output Polyline 


5-56 


Polymarker 


v_pmarker 


Output Polymarker 


5-58 


Alpha Text 


v_atext 


Output Alpha Text 


5-42 


Cursor 
Addressable Text 


v_curtext 


Output Cursor 


5-50 


Graphics Text 


v_gtext 


Output Graphics Text 


5-53 


Fill Area 


v_fillarea 


Output Filled Area 


5-51 


Cell Array 


v_cellarray 


Output Cell Array 


5-45 


Generalized 

Drawing 

Primitives 


v_arc 
v_circle 
v_bar 
v_pieslice 


Output Arc 
Output Circle 
Output Bar 
Output Pie Slice 


5-40 
5-49 
5-44 
5-54 
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v_arc () 



Purpose 
Syntax 
Data Types 



Input 



Output arc 

v_arc (devjiandle, x, y, radius, begang, endang) 

INT16 v_arc(); 
INT16 dev_handle; 
INT16x, y; 
INT16 radius; 
INT16 begang; 
INT16 endang; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 



x-coordinate of center point of arc. 



Function 
Returns 



Description 



y-coordinate of center point of arc. 

radius 

Radius. 

begang 

Start angle in tenths of degrees. 
to 3600 

endang 

End angle in tenths of degrees. 
to 3600 

Function v_arc returns error state. 

if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine draws arcs using current line 
attributes. Arcs are defined by the center point 
and two end points of the arc. The radius is 
assumed to be measured along the x-(horizontal) 
axis. All angle specifications assume that 
degrees is 90 degrees to the right of vertical (or 
3:00), with values increasing in the 
counterclockwise direction. 
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Arcs and pie slices are always drawn in a 
counterclockwise direction. The start angle does 
not need to be larger than the ending angle. If a 
start angle of 40 degrees and an ending angle of 15 
degrees are given, an arc would be drawn 
counter-clockwise from the 40 degree angle to the 
15 degree angle. 



FIGURE 5-1 Angle Specification 



: > | 



1800°' 





2700" 
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v_atext () 



Purpose 
Syntax 
Data Types 



Input 



Output 



Function 
Returns 



Description 



Output alpha text 

v_atext (devjiandle, string, &x_out, &y_out) 

INT16 v_atext (); 
INT16 dev_handle; 
INT8 string[ ]; 
INT16 x_out; 
INT16 y_out; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

string 

Text string. 

Passed as a contiguous stream of bytes. 

x_out 

x-coordinate of text position (in NDC units) after 
the text string has been output. This is the same 
value that is returned if Inquire Alpha Text 
Position were invoked. 

y_out 

y-coordinate of text position (in NDC units) after 
the text string has been output. This is the same 
value that is returned if Inquire Alpha Text 
Position were invoked. 

Function v_atext returns error state. 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine outputs text at the current alpha text 
position, honoring all current alpha text attributes 
(subscripting, under-line, alpha text font, etc.), 
and the cursor is positioned at the end of the 
string. The alpha text position is updated 
appropriately after outputting the text string. 
Receipt of the ASCII character <CR> (carriage 
return) causes the alpha text position to be set to 
the beginning of the line (x = 0). Receipt of a LF 



5-42 Control Functions 



(line feed) causes the alpha text position to be 
advanced by the current line spacing (y = y-line 
spacing). All other control characters/nonprintable 
characters (ASCII characters 0-31) are not output. 
Attempting to display characters past the X or Y 
maximum of the display surface produces device- 
dependent results. 

Alpha text is useful for outputting word processor 
quality text display on CRTs, printers, etc., and is 
displayed to the best resolution and accuracy of 
the hardware. 

Note 

In the C language the '\n' character is interpreted 
as a line feed character. Use '\n\r' to get a line 
feed, carriage return combination. 
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v_bar () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Output bar 

v_bar (devjiandle, xy) 

INT16v_bar(); 
INT16 devjiandle; 
INT16 xy[4]; 

devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

xy[0] 

x-coordinate of lower left-hand corner of bar 

xy[l] 

y-coordinate of lower left-hand corner of bar 

xy[2] 

x-coordinate of upper right-hand corner of bar 

xy[3] 

y-coordinate of upper right-hand corner of bar 

Function v_bar returns error state. 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine draws a rectangular area using 
current filled area attributes of interior style, fill 
style and color. 
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v_cellarray () 



Purpose Output cell array 

Syntax v_cellarray (devjiandle, xy, rowjength, el_per_row, 

num_rows, wr_mode, colors) 

Data Types INT16 v_cellarray (); 
INT16 devjiandle; 
INT16xy[4]; 
INT16 rowjength; 
INT16 el_per_row; 
INT16 num_rows; 
INT16 wr_mode; 
INT16colors[]; 

Input devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

xy[0] 

x-coordinate of lower left-hand corner (NDC units) 

xy[l] 

y-coordinate of lower left-hand corner (NDC units) 

xy[2] 

x-coordinate of upper right-hand corner (NDC units) 

xy[3] 

y-coordinate of upper right-hand corner (NDC units) 

rowjength 

Length of each row in color index array 

el_per_row 

Number of elements used in each row of color 
index array. 

numjows 

Number of rows in color index array. 

wr_mode 

Pixel operation to be performed. 

See Set Writing Mode function for list of operations. 

colors 

Color index array (stored one row at time). 
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Function Function v_cellarray returns error state. 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq..error. 

Description This routine outputs pixels to the device and can 
be used for imaging. 

Each row in the color index array is expanded 
evenly to fill the entire width of the rectangle 
specified by pixel replication. Each row in the 
color index array is also replicated the appropriate 
number of times to fill the entire height of the 
rectangular area evenly with the color pattern, 
starting from the top of the rectangular area and 
filling downward. 

For example, if there are two rows and three 
elements per row, the vertical dimension of the 
rectangle is divided into two equal parts, and the 
horizontal dimension is divided into three equal 
parts. The rectangle is filled in the upper left- 
hand corner of the area with the color index 
specified in the first element of the color index 
array, etc. If the device can't do cell arrays, the 
area is outlined in the current line color. 

The input array to the cell array function is a list of 
color indices. Each of these indices indicates the 
color to use to fill one of the cells of the cell array. 
The "XY" array defines the corners of the 
rectangle. "Elements per row" and "number of 
rows" define how many sections (cells) to divide 
the rectangle into. For example, to create the cell 
array shown in Figure 5-2, the following values 
would be entered: 

xy(0) = 24 
xy(l) = 300 
xy(2) = 50 
xy(3) = 500 
rowjength = 3 
el_per_row = 3 
numjows ■■= 2 
wr mode = 4 
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colors(0 
colors(l 
colors(2 
colors(3 
colors(4 
colors(5 



= 2 
= 4 
= 5 
= 3 
- 1 
= 4 



We could also have used the following set of 
values: 

xy(0) = 24 
xy(l) = 300 
xy(2) = 50 
xy(3) - 500 
row_length = 5 
el_per_row = 3 



num_rows = 2 

wr_mode — 4 

colors(0 

colors(l 

colors(2 

colors(3 

colors(4 

colors(5 

colors(6 

colors(7 

colors (8 

colors(9 



2 

4 

5 

data value not used 

data value not used 

3 

1 

4 

data value not used 

data value not used 



Note in the second example, that the "row length" 
is set to 5 and the colors array has been increased. 
Since the "elements per row" value is 3, we only 
use the first three of the five elements per row. 
This mechanism is useful when the user only 
wants to use a portion of a large array of data. 

The "colors" values correspond to entries from the 
currently defined color table. 

In this example, we used a writing mode value of 
4. However, any of the sixteen writing mode 
values could have been used. 

The term "pixel" is synonymous with the words 
"raster" and "pel". The current standards 
documents use the word "pixel". Each "pixel" 
within a cell is displayed with the indicated color. 



Output Functions 5-47 



By specifying an array that is 320 x 200 pixels long 
and indicating the colors of the display, the user 
could set the color of each individual pixel on the 
screen using the current color graphics card. 



FIGURE 5-2 Cell Array 
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v_circle () 



Purpose Output circle 

Syntax v_circle (devjiandle, x, y, radius) 

Data Types INT16 v_circle (); 
INT16 dev_handle; 
INT16 x; 
INT16 y; 
INT16 radius; 

Input devjhandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

x 

x-coordinate of center point of circle 



Function 
Returns 



Description 



y-coordinate of center point of circle 

radius 

Radius 

Function v_circle returns error state. 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine draws a circle, specified by a center 
point and filled radius. The radius is assumed to 
be measured along the x-axis (horizontal). Since 
circles are a special type of filled area, they are 
affected by filled area attributes including interior 
style, fill style and color. 
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v_curtext () 



Purpose Output cursor addressable text 

Syntax v_curtext (dev_handle, string) 

Data Types INT16 v_curtext (); 
INT16 devjiandle; 
INT8 string[ ]; 

Input devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

string 

Text string. 

Passed as a contiguous stream of bytes. 

Function Function v_curtext returns error state. 

Returns if no error 

-1 if error 

Actual error can be retrieved by invoking vq_error. 

You must be in Cursor Addressing Mode to output 

cursor addressable text. 

Description For CRTs, this routine outputs text at the current 
cursor position, honoring all the cursor text 
attributes (such as color, reverse video, etc.). 
Note that new text replaces (overwrites) old text at 
the same location. 

Only text that will fit onto the line of the cursor 
will be displayed, and it will not wrap onto the 
next line at the left edge. 
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vjillarea () 


Purpose 


Output filled area 


Syntax 


vjillarea (devjiandle, count, xy) 


Data Types 


INT16 v fillarea (); 
INT16 devjiandle; 
INT16 count; 
INT16 xy[2n]; 



Input devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

count 

Number of vertices in polyline. 

x y 

Array of coordinates of polyline (NDC units) 

xy[0] 

x-coordinate of first point 

xyll] 

y-coordinate of first point 

xy[2] 

x-coordinate of second point 

xy[3] 

y-coordinate of second point 



xy[2n-2] 

x-coordinate of last point 

xy[2n-l] 

y-coordinate of last point 

Function Function vjillarea returns error state. 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 
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Description This routine outputs a filled area to the device 

using current fill area attributes of fill color index, 
fill interior style index, fill style index. HOLLOW 
filled areas are outlined with a solid border using 
the current fill color. SOLID, HATCH, and 
PATTERN filled areas are not outlined. 



FIGURE 5-3 Filled Area 
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v_gtext () 



Purpose Output graphics text 

Syntax v_gtext (dev_handle, x, y, string) 

Data Types INT16 v_gtext (); 
INT16 dev_handle; 
INT16 x,y; 
INT8 string[ ]; 

Input devjhandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 



Function 
Returns 



Description 



x-coordinate of alignment point of text (NDC units) 

y 

y-coordinate of alignment point of text (NDC units) 

string 

Text string. 

Passed as a pointer to characters or array. 
Characters must be printable characters, ASCII 
<space> and above. 

Function v_gtext returns error state. 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine outputs graphics text with current 
attributes to the device. The X, Y location is the 
position the text will be aligned to, taking into 
account the current graphics text alignment values. 
Any text that is outside of the display surface is 
not displayed. 
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v_pieslice () 



Purpose 
Syntax 
Data Types 



Input 



Output pie slice 

v_pieslice (dev_handle, x, y, radius, begang, endang) 

INT16 v_pieslice (); 
INT16 devjiandle; 
INT16 x; 
INT16 y; 
INT16 radius; 
INT16 begang; 
INT16 endang; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 



x-coordinate of center point of arc (NDC units) 



Function 
Returns 



Description 



y-coordinate of center point of arc (NDC units) 

radius 

Radius (NDC units) 

begang 

Start angle in tenths of degrees 
to 3600 

endang 

End angle in tenths of degrees 
to 3600 

Function v_pieslice returns error state. 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine draws pie slices by specifying the 
center point and two points on the arc. The radius 
is assumed to be measured along the x- 
(horizontal) axis. Since pie slices are a special type 
of filled area, they are affected by filled area 
attributes including interior style, fill style and 
color. 



5-54 Control Functions 



All angle specifications assume that degrees is 90 
degrees to the right of vertical, with values 
increasing in the counter-clockwise direction. (See 
Figure 5-1.) 
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v_pline 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Output polyline 

v_pline (dev_ handle, count, xy) 

INT16v_pline(); 
INT16 dev_handle; 
INT16 count; 
INT16 xy[2n]; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

count 

Number of vertices (x,y pairs) in polyline 

x y 

Array of coordinates of polyline (NDC units) 

xy[0] 

x-coordinate of first point 

xy[l] 

y-coordinate of first point 

xy[2] 

x-coordinate of second point 

xy[3] 

y-coordinate of second point 

xy[2n-2] 

x-coordinate of last point 

xy[2n-l] 

y-coordinate of last point 

Function v_pline returns error state. 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine outputs a polyline (with the current 
polyline attributes of line style, width and color) to 
the device. It moves to the first point and draws a 
line between subsequent points. 
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FIGURE 5-4 Polyline 
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v_pmarker () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Output polymarker 

v_pmarker (dev_handle, count, xy) 

INT16 v_pmarker (); 
INT16 devjiandle; 
INT16 count; 
INT16 xy[2n]; 

devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

count 

Number of markers. 

xy 

Array of coordinates (NDC units) 

xy[0] 

x-coordinate of first marker. 

xy[l] 

y-coordinate of first marker. 

xy[2] 

x-coordinate of second marker. 

xy[3] 

y-coordinate of second marker. 

xy[2n-2] 

x-coordinate of last marker. 

xy[2n-l] 

y-coordinate of last marker. 

Function v_pmarker returns error state. 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine outputs markers (with the current 
polymarker attributes of scale, type and color) to 
the device. At least six marker types are provided 
as specified in the Set Polymarker Type routine. 
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FIGURE 5-5 Polymarkers 
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Attribute Functions 



This section discusses primitive attributes, the general 
characteristics of a display primitive assigned at the time it is 
defined by the application program. You can interrogate current 
attribute values and change them at any time after GSS-DRIVERS 
is initiated. 



Attribute Functions 

The purpose of the attribute functions is to specify general 
characteristics for output primitives. Some attributes control the 
geometric aspects of the primitives. These are aspects that affect 
the shape or size of a primitive (for example, character height). 
Geometric attributes are expressed in NDC units. A second type 
of attribute controls the non-geometric aspects of primitives; 
these modify the appearance of primitives without changing their 
shape (for example, line style). 
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TABLE 5-3 Attribute Functions 






Function 


Routine 


Description 


Page 


Polyline 


vsl_color 


Set Polyline 


5-86 


Attributes 




Color Index 






vsl_type 


Set Polyline 
Line Type 


5-87 




vsl_width 


Set Polyline 
Line Width 


5-88 


Polymarker 


vsm_color 


Set Polymarker 


5-89 


Attributes 




Color Index 






vsm_height 


Set Polymarker 
Height 


5-90 




vsm_type 


Set Polymarker 
Type 


5-91 


Alpha Text 


vsa_color 


Set Alpha Text 


5-72 


Attributes 




Color Index 






vsa_font 


Set Alpha Text 
Font and Size 


5-73 




vsa„spacing 


Set Alpha Text 
Line Spacing 


5-79 




vsa_overstrike 


Set Alpha Text 
Overstrike Mode 


5-76 




vsa_passthru 


Set Alpha Text Pass 
Through Mode 


5-77 




vsa_quality 


Set Alpha Text 
Quality 


5-78 




vsa_supersub 


Set Alpha Text 
Subscript/ 
Superscript Mode 


5-80 




vsa_underline 


Set Alpha Text 
Underline Mode 


5-81 


Cursor Text 


vcur_color 


Set Cursor Text 


5-68 


Attributes 




Color Index 






vcur_att 


Set Cursor Text 
Attributes 


5-66 




v_rvOff 


Reverse Video Off 


5-64 




v_rvon 


Reverse Video On 


5-65 
(continued) 
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TABLE 5-3 (continued) 






Function 


Routine 


Description 


Page 


Graphics Text 


vst_height 


Set Character Height 


5-96 


Attributes 


vst_alignment 


Set Graphics Text 
Alignment 


5-92 




vst_rotation 


Set Graphics Text 
String Baseline 
Rotation 


5-98 




vst_color 


Set Graphics Text 
Color Index 


5-94 




vst_font 


Set Graphics Text 
Font 


5-95 


Color 


vsb_color 


Set Background 


5-82 


Attributes 




Color Index 






vs_color 


Set Color 
Representation 


5-69 


Fill Attributes 


vsf_color 


Set Fill Color 
Index 


5-83 




vsf_interior 


Set Fill Interior 
Style 


5-84 




vsf_style 


Set Fill Style 
Index 


5-85 


Input 


vs_editchars 


Set Line Edit 


5-71 


Attributes 




Characters 
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v_rvoff 



Purpose Reverse video off 

Syntax v_rvoff (dev_handle) 

Data Types INT16 v_rvoff (); 

INT16 devjiandle; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_rvoff returns error state. 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description When you are in Cursor Addressing Mode, this 
routine displays subsequent cursor addressable 
text in standard video. It is only applicable to CRT 
devices. 
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v_rvon 



Purpose Reverse video on 

Syntax v_rvon (dev_handle) 

Data Types INT16 v_rvon (); 

INT16dev handle; 

Input devjhandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Function Function v_rvon returns error state. 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description When you are in Cursor Addressing Mode, this 
routine displays subsequent cursor addressable 
text in reverse video. It is only applicable to CRT 
devices. 
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vcur_att () 



Purpose Set cursor text attributes 

Syntax vcur_att (devjiandle, req_att, seLatt) 

Data Types INT16 vcur_att (); 
INT16 dev_handle; 
INT16 req_att[4]; 
INT16 sel_att[4]; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

req_att[0] 

Requested Reverse Video Mode. 

= Disable Reverse Video 

1 = Enable Reverse Video 

2 = Do not change current state 

3 = Toggle Reverse Video Status 

req_att[l] 

Requested Underline Cursor Text Mode. 

= Disable Underline Cursor Text 

1 = Enable Underline Cursor Text 

2 = Do not change current state 

3 = Toggle Underline Cursor Text Status 

req_att[2] 

Requested Blink Text Mode. 

= Disable Blink Cursor Text 

1 = Enable Blink Cursor Text 

2 = Do not change current state 

3 = Toggle Blink Cursor Text Status 

req_att[3] 

Requested Bold Cursor Text Mode. 

= Disable Bold Cursor Text 

1 == Enable Bold Cursor Text 

2 = Do not change current state 

3 = Toggle Bold Cursor Text Status 
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Output 



Function 
Returns 



Description 



sel_att[0] 

Selected Reverse Video Mode. 

= disabled 

1 = enabled 

sel_att[l] 

Selected Underline Cursor Text Mode. 

= disabled 

1 = enabled 

sel_att[2] 

Selected Blink Text Mode. 

= disabled 

1 = enabled 

sel_att[3] 

Selected Bold Cursor Text Mode. 

= disabled 

1 = enabled 

Function vcur_att returns error state 

if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine allows the attributes of Reverse 
Video, Underline, Blink, and Bold to be set for 
subsequent cursor addressable text. The Reverse 
Video Mode can be set in this routine or in the 
Reverse Video On and Reverse Video Off 
functions. Whichever was called last will be used 
as the reverse video attribute for subsequent 
cursor addressable text. 

This function can be used to do an inquiry of the 
current status by setting all modes to DO NOT 
CHANGE STATUS. The current state would then 
be returned in sel att. 
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vcur_color () 



Purpose 
Syntax 

Data Types 



Input 



Output 



Function 
Returns 



Description 



Set cursor text color index 

vcur_color (dev_handle, fore_requested, back_requested, 
&fore_selected, &back_ selected) 

INT16 vcur_color (); 
INT16 dev_handle; 
INT16 fore_requested; 
INT16 back_requested; 
INT16fore_selected; 
INT16 back_selected; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

fore_requested 

Color index of the foreground of subsequent 
output cursor text, 
default = 1 

back_requested. 

Color index of the background of subsequent 
output cursor text, 
default = 

fore_selected 

Color index selected for cursor text foreground. 

back_selected 

Color index selected for cursor text background. 

Function vcur_color returns error state 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the foreground and background 
colors for cursor addressable text. If an invalid 
color index is specified, it is mapped to the index 
closest to the current device's capabilities. 
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vs_color () 



Purpose Set color representation 

Syntax vs_color (devjiandle, ind_in, rgb_in, rgb_out) 

Data Types INT16 vs_color (); 
INT16 dev_handle; 
INT16 indjn; 
INT16 rgb_in[3]; 
INT16 rgb_out[3]; 

Input devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

indjn 

Color index requested. 

rgb[0] 

Red color intensity. 

to 1000 (tenths of percent) 

rgb[l] 

Green color intensity. 

to 1000 (tenths of percent) 

rgb[2] 

Blue color intensity. 

to 1000 (tenths of percent) 

Output rgb_out[0] 

Red color intensity selected. 
to 1000 (tenths of percent) 

rgb_out[l] 

Green color intensity selected. 
to 1000 (tenths of percent) 

rgb_out[2] 

Blue color intensity selected. 
to 1000 (tenths of percent) 

Function Function vs_color returns 

Returns s=0 if index selected 

-1 if error 
Actual error can be retrieved by invoking vq_error. 
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Description This routine is used to map indices to new colors. 
At least two color indices are provided. If the 
desired index is outside of the device's 
capabilities, then the closest device index is set. If 
a color intensity of less than is requested, it is 
mapped to 0. If a color intensity greater than 1000 
is requested, it is mapped to 1000. 

To change the appearance of a color, you must 
select the desired levels of the three color 
components (red, green and blue) that make up 
the index. This can be used to create nondefault 
colors such as brown or orange. The new color 
will only be visible on devices that support color 
definition. 

If the value of the function vs_color is negative 
then an error occurred. If the function returns a 
value greater than or equal to zero, then it is equal 
to the color index selected, and no error occurred. 
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vs_editchars () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set line edit characters 

vs_editchars (dev_handle, line_del, char_del) 

INT16vs_editchars(); 
INT16 devjiandle; 
INT8 line_del; 
INT8 char_del; 

devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

line_del 

Character to use to delete previous line. 
Default = *U (NAK) 

char_del 

Character to use to delete previous character. 
Default = *H (Backspace) 

Function vs_editchars returns error state 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the current line editing 
characters. They are applied to the Input String 
function only. 
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vsa_color () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set alpha text color index 

vsa_color (dev.handle, ind_in) 

INT16 vsa_color (); 
INT16 dev_handle; 
INT16 indjn; 

devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

ind_in 

Requested text color index. 
1 to device maximum 

Function vsa_color value returned is: 
>:0 if color index selected 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine selects the alpha text color index for 
subsequent output. 

At least two color indices are provided. Color 
indices range from to a device-dependent 
maximum. 

If the color index requested is not valid, the closest 
value within the range of the current device's 
capabilities is selected. 
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vsa_font () 

Purpose Set alpha text font and size 

Syntax vsa_fon1 (dev_handle, font_in, sizejn, fon1_cap) 

Data Types INT16 vsajont (); 
INT16 dev_handle; 
INT16font_in; 
INT16 sizejn; 
INT16font_cap[8]; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

font_in 

Requested font. 

If requested font is not available, font 1 (standard 

font) is used. Fonts 1 to 3 are fixed-space fonts. 

1 = Normal/standard font (default) 

2 = Bold (always provided for printers) 

3 = Italics 

4 = Proportionally spaced normal font 

5 = Proportionally spaced bold 

6 = Proportionally spaced italics 
>6 — Device-dependent 

size_in 

Requested text size. 
1 to device maximum 

where size n+ 1 is larger (occupies more area) 
than size n. 

Output font_cap[0] 

Text size index selected. 

font_cap[l] 

Number of horizontal character cell positions across 
the display surface in this font. This is -1 if the 
font selected is a proportional font, since the 
character cell size is not constant. 

font_cap[2] 

Number of vertical character cell positions down the 
display surface in this font. 
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font_cap[3] 

Number of horizontal character cell positions 
represented by the distance specified in font_cap[6]. 
The ratio (font_cap[6]/ font_cap[3]) can be used to 
determine the width of a character cell, including 
any roundoff error. 

font_cap[4] 

Number of vertical character cell positions 
represented by the distance specified in font_cap[7]. 
The ratio (font_cap[7]/ font_cap[4]) can be used to 
determine the height of a character cell, including 
any roundoff error. 

font_cap[5] 

Proportional spacing flag. 

= No 

1 = Yes 

If this value is 1, then the size represented by 
font_cap[6] and font_cap[7] may not represent the 
selected font. This is the case if the desired 
font is proportionally spaced. 

font_cap[6] 

Width in NDC units of the number of character 
cells in the selected font specified in font_cap[3]. 
The ratio (font_cap[6]/ font_cap[3]) can be used to 
determine the width of a character cell, including 
any roundoff error. This value is not accurate if 
the proportional spacing flag is set, since the 
character cell size is not constant. 

font_cap[7] 

Height in NDC units of the number of character 
cells in the selected font specified in font_cap[5]. 
The ratio (font_cap[7]/ font_cap[4]) can be used to 
determine the height of a character cell including 
any roundoff error. 

Function Function vsajont returns 

Returns ^0 if font selected 

-1 if error 
Actual error can be retrieved by invoking vq_error. 
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Description This routine sets the hardware alpha text font and 
size for subsequent output alpha text functions. 

On printers, the resident font capability is used. 
Unlike graphics text, alpha text capabilities do not 
include font emulation. 
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vsa_overstrike () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set alpha text overstrike mode 

vsa_overstrike (devjiandle, mode_in) 

INT16 vsa_overstrike (); 
INT16 dev_handle; 
INT16 modejn; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

mode_in 

Overstrike mode requested. 

= off (default) 

1 = on 

If an invalid mode is requested, the default is 
selected. 

Function vsa_overstrike returns 
>0 if mode selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine turns overstriking on or off. The 
default is overstriking off. When this mode is on, 
the alpha text position is not automatically 
advanced after each character is output; however, 
carriage return and line feed can still modify the 
current alpha text position. 
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vsa_passthru () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set alpha text pass through mode 

vsa_passthru (dev_handle, modejn) 

INT16 vsa_passthru (); 
INT16 devjiandle; 
INT16 modejn; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

mode_in 

Pass through mode requested. 

- off (default) 

1 = on 

If an in valid mode is requested, the default is 
selected. 

Function vsa_passthru returns 
>0 if mode selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine turns pass through mode on or off. 
Pass through mode enables all text to be output. 
Attributes such as font, color, superscripting, etc. 
may not be honored. When this mode is in effect, 
any text displayed does not modify the alpha text 
position. All characters, including control 
characters are sent directly to the device. 

This routine may be used to send device- 
dependent set-up strings to a particular device. 
The default is pass through OFF. 
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vsa.quality () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set alpha text quality 

vsa_quality (devjiandle, mQde_in) 

INT16 vsa_quality (); 
INT16 devjiandle; 
INT16 modejn; 

devjiandle 

Device handle returned from v_ppnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

mode_in 

Text quality requested. 

to 100 

where = Lowest (draft) quality 
100 = Highest quality (default) 
If an invalid mode is requested, the default (high 
quality) is selected. The number of quality levels 
is device-dependent. 

Function vsa_quality returns 
2:0 if mode selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the alpha text quality level to 
some level between draft quality and high quality. 
The default is high quality. In draft quality range, 
small imperfections due to bidirectional printing or 
print head speed are acceptable. In high quality 
range the output is the best possible. 

Alpha text quality is a device-dependent attribute 
normally associated with printers. CRTs often 
may have multiple alpha fonts, but do not 
differentiate by quality levels. On dot matrix 
printers, quality usually affects the number of dots 
used to display a character. 
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vsa_spacing () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set alpha text line spacing 

vsa_spacing (devjiandle, spacjn) 

INT16 vsa_spacing (); 
INT16 dev_handle; 
INT16 spacejn; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

spac_in 

Line spacing requested, 
positive value in NDC units 

Function vsa, spacing returns 
3:0 if spacing selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the vertical spacing between lines 
of alpha text. It determines the amount of 
movement down the page when it receives a line 
feed control character in an output alpha text 
string. The default is single spacing; that is, the 
amount of spacing between lines of alpha text is 
the same as the default character cell height. 

Line spacing must always be a positive value. It 
specifies a decrement in the absolute vertical 
position when a line feed is encountered. You will 
need to update the line spacing to the character 
cell height of the new font (or whatever is desired) 
whenever fonts are changed. 
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vsa_supersub () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set alpha text subscript/superscript mode 

vsa_supersub (dev_handle, modejn) 

INT16 vsa_supersub (); 
INT16 dev_handle; 
INT16 modejn; 

devjhandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

mode_in 

Mode requested. 

= Subscripting and superscripting off (default) 

1 = Subscripting on 

2 = Superscripting on 

If an invalid mode is requested, mode = is 
selected. 

Function vsa_supersub returns 
>0 if mode selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets subscripting or superscripting for 
subsequent alpha text. It causes output to be 
offset above or below the line and is useful for 
footnotes, etc. The default is subscripting and 
superscripting OFF. 
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vsa_underline () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set alpha text underline mode 

vsa_underline (devjiandle, mode_in) 

INT16 vsa_underline (); 
INT16 devjiandle; 
INT16 modejn; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

mode_in 

Underline mode requested. 

= off (default) 

1 = on 

If an invalid mode is requested, the default is 
selected. 

Function vsa_underline returns 
>0 if color index selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine turns alpha text underlining ON or 
OFF. The default is underlining OFF. 
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vsb_color () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set background color index 

vsb_color (dev_handle, ind_in) 

INT16vsb_color(); 
INT16 dev_handle; 
INT16 ind_in; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

ind_in 

Background color index. 
to device maximum 

Function vsb_color returns 
>0 if color index selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the device's background color to 
the desired index. On some devices, this change 
may not appear until the next Clear Workstation 
function is called. If the index is not valid, no 
change will be made in the background index. 
However, the color index selected is always 
returned. This function is not applicable on 
plotters or printers. 
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vsf_color () 



Purpose Set fill color index 

Syntax vsf .color (deyjiandle, indjn) 

Data Types INT16 vsf_color (); 
INT16 dev_handle; 
INT16 indjn; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

ind_in 

Requested fill color index. 
to device maximum 

Function Function vsf_color returns 

Returns sO if color index selected 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine determines the color to be used for 
filling polygons, bars, pie slices and circles. 

At least two color indices are provided. Color 
indices range from to a device-dependent 
maximum. If the color specified is invalid, the 
closest value in range is chosen. However, the 
color index selected is returned. 
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vsfjnterior () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set fill interior style 

vsf_interior (dev_handle, styl_in) 

INT16 vsfjnterior (); 
INT16 dev_handle; 
INT16 styl_in; 

devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

styl_in 

Requested fill interior style. 

= HOLLOW 

1 = SOLID 

2 = PATTERN 

3 = HATCH 

Function vsfjnterior returns 
>0 if style selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the style of fill to be used for 
filled areas, bars, pie slices and circles. 

When you select HOLLOW style, the area is 
outlined in the current fill color. A SOLID area is 
filled in the current color. PATTERN and HATCH 
are determined by SET FILL STYLE INDEX. If the 
requested style is invalid, then HOLLOW is used. 
SOLID, HATCH, and PATTERN filled areas are 
not outlined. 
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vsf_style () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set fill style index 

vsf_style (dev.handle, ind_in) 

INT16 vsf_style (); 
INT16 devjiandle; 
INT16 indjn; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

ind_in 

Requested fill style index for PATTERN or HATCH 
fill. 

Function vsf_style returns 
>0 if index selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine selects a fill style based on the fill 
interior style. This index has no effect if the 
interior style is either HOLLOW or SOLID. If the 
requested index is not available, index 1 is used. 

The index references a HATCH style if the fill 
interior style is HATCH, or a PATTERN if the fill 
interior style is PATTERN. At least six HATCH 
styles are provided: 

1 = Narrow spaced +45 degree lines 

2 = Medium spaced +45 degree lines 

3 = Widely spaced +45 degree lines 

4 = Narrow spaced +45 & -45 degree lines 

5 = Medium spaced +45 & -45 degree lines 

6 = Widely spaced +45 & -45 degree lines 
>6 = Device-dependent 

There is no difference between HATCH and 
PATTERN styles on many devices. For example 
on some devices, asking for a HATCH style of 3 
will result in the same output as asking for a 
PATTERN style of 3. 
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vsLcolor () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set polyline color index 

vsLcolor (dev_handle, indjn) 

INT1 6 vsLcolor (); 
INT16 devjiandle; 
INT16 Indjn; 

devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

ind_in 

Requested color index. 
to device maximum 

Function vsLcolor returns 
>0 if color index selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the color index for subsequent 
polylines and arcs. 

At least two color indices are provided. Color 
indices range from to a device-dependent 
maximum. If the color specified is invalid, the 
closest value in range is chosen. However, the 
color index selected is always returned. 

To change the appearance of a color, you must 
select the desired levels of the three color 
components (red, green and blue) that make up 
the index by calling the Set Color Representation 
routine. This can be used to create non-default 
colors such as brown or orange. Then Set Polyline 
Color Index may be called with this index. The 
new color will only be visible on devices that 
support color definition. 
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vsLtype () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set polyline line type 

vsljype (dev_handle, type_in) 

INT16 vsljype (); 
INT16 dev_handle; 
INT16 type_in; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

type_in 

Requested line style. 

1 = Solid 

2 = Long dashed 

3 = Dotted 

4 = Dashed-dotted 

5 = Medium dashed 

6 = Dashed with two dots 
>6 = device-dependent 

Function vsljype returns 
5:0 if line type selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the line style (dash pattern) for 
subsequent polylines and arcs. The total number 
of line styles available is device-dependent, 
however, the above six line styles are provided. If 
the requested line style is out of range, then line 
style 1 is used. 
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vsLwidth () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set polyline line width 

vsLwidth (dev_handle, wid_in) 

INT16 vsLwidth (); 
INT16 dev_handle; 
INT16 widjn; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

wid_in 

Requested line width in NDC units. 

Function vsLwidth returns 
>0 if line width selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the width for subsequent 
polylines and arcs. 

If the requested line width is outside of the 
device's capabilities, the line width is set to one 
device unit and returned in NDC units. 
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vsm_color () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set polymarker color index 

vsm_color (devjiandle, ind_in) 

INT16 vsm_color(); 
INT16 devjiandle; 
INT16 ind_in; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

ind_in 

Requested polymarker color index. 
to device maximum 

Function vsm_color returns 
2:0 if color index selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the color index in which 
subsequent markers will be displayed. 

At least two color indices are provided. Color 
indices range from to a device-dependent 
maximum. If the color specified is invalid, the 
closest value in range is chosen. However, the 
color index selected is always returned. 

To change the appearance of a color, you must 
select the desired levels of the three color 
components (red, green and blue) that make up 
the index. This can be used to create non-default 
colors such as brown or orange. The new color 
will only be visible on devices that support color 
definition. 
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vsm_height () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set polymarker height 

vsm_height (dev_handle, hgt_in) 

INT16 vsm_height (); 
INT16 devjiandle; 
INT16 hgtjn; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

hgt_in 

Requested polymarker height in NDC units. 

Function vsm_height returns 
>0 if height selected in NDC units 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the size of subsequent 
polymarkers. 

If the requested marker height is outside of the 
capabilities of the device, the marker height is set 
to the closest device size. If the requested marker 
height does not exactly map to a device-supported 
size, then the largest device size that is not greater 
than the requested marker height is used. Marker 
sizes, just like graphics text sizes are specified by 
NDC values. 
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vsmjype () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set polymarker type 

vsmjype (devjiandle, type_in) 

INT16 vsmjype (); 
INT16 devjiandle; 
INT16typeJn; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

type_in 

Requested polymarker type. 
1 = . 
2- + 

3 = * 

4 = O 

5 = X 

6 = Diamond 

>6 = device-dependent 

Function vsmjype returns 
5:0 if marker type selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the polymarker (symbol) type for 
subsequent polymarker operations. 

The total number of markers available is device- 
dependent, however, the above six marker types 
are provided. If the requested marker type is out 
of range, type 3 is used. 
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vst_alignment () 



Purpose Set graphics text alignment 

Syntax vst_alignment (devjiandle, hor_in, vert_in, &hor_out, 

&vert_out) 

Data Types INT16 vst_alignment (); 
INT16 devjiandle; 
INT16 hor_in; 
INT16 vert_in; 
INT16 hor_out; 
INT16 vert_out; 

Input devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

hor_in 

Horizontal alignment requested. 

Horizontal alignment applies to the width of the 

character body not the character cell. 

= Left justified (default) 

1 = Center justified 

2 = Right justified 

If an invalid horizontal alignment is requested, the 
default of left justified is selected. 

vert_in 

Vertical alignment requested. 

Vertical alignment applies to the height of the 

character body not the character cell. 

= Bottom justified (default) 

1 = Center justified 

2 = Top justified 

If an invalid vertical alignment is requested, the 
default of bottom is selected. 

Output hor_out 

Horizontal alignment selected. 

vert_out 

Vertical alignment selected. 
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Function 
Returns 



Description 



Function vst_alignment returns error state. 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets graphics text horizontal and 
vertical alignment. This controls the positioning of 
the text extent rectangle in relation to the graphics 
text position. The default alignment places the 
bottom left-hand corner of the character (not the 
character cell) at the graphics text position. 



FIGURE 5-6 Text Alignment 
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vst_color () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set graphics text color index 

vst_color (devjiandle, ind_in) 

INT16 vst_colbr (); 
INT16 dev_handle; 
INT16 indjn; 

dev_haridle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are opert. 

ind_in 

Requested text color index. 
to device maximum 

Function vst_color returns 
>0 if color index selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the graphics text color index. 

At least two color indices are provided. Color 
indices range from to a device-dependent 
maximum. However, the color index selected is 
always returned. If the color index requested is 
not valid, the closest value within the range of the 
current device's capabilities is selected. 
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vstjont () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set graphics text font 

vst_font (dev_handle, fontjn) 

INT16 vstjont (); 
INT16 devjiandle; 
INT16 fontjn; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

font_in 

Requested hardware graphics text font number. 
1 to device-dependent maximum 

Function vst_font returns 
>0 if font selected 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the hardware text font for 
graphics text. 

Fonts are device-dependent and are specified from 
1 to a device-dependent maximum. If a font is 
selected outside of device capability, font 1 is 
used. 
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vstjieight () 



Purpose 
Syntax 

Data Types 



Input 



Output 



Function 
Returns 



Description 



Set character height 

vstjieight (devjiandle, rqjieight, &char_width, &celLwidth, 
&cell height) 

INT16 vst_height (); 
INT16 dev_handle; 
INT16 rq_height; 
INT16 char_width; 
INT16 celLwidth; 
INT16 celLheight; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

rq_height 

Requested character height in NDC units. 

char_width 

Actual character width selected in NDC units. 

cell_width 

Character cell width in NDC units. 

cell_height 

Character cell height in NDC units. 

Function vstjieight returns error state. 
2:0 if height selected in NDC units 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the size of subsequent graphics 
text. 

The height specified is the height of the actual 
character (baseline to top of tallest character), not 
the character cell. If the requested size is outside 
of device capabilities, the closest available size on 
the device is used. If the desired character height 
does not map exactly to a device size, then the 
largest character height that does not exceed the 
desired size is used. 
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The default size permits at least eighty characters 
to be displayed horizontally across the display 
surface and twenty-four characters to be displayed 
vertically down the display surface. 



Code Example — Set Character Height 

titl size = 160; 

xheight = vst_height(dev_handle, title_size, &xwidth, &cwidht, &cheight); 

/* set a new character height */ 
linejength = 800; 

I* we want to make sure that the text we write will not 
be longer than this line */ 
while ((cwidth * 12) > = linejength && titl_size >= 20) { 
/* loop making sure that a string 12 characters long 

won't be longer than linejength */ 
title_size -=10; 

xheight = vstjieight(devjiandle, title.size, &xwidth, &cwidth, &cheight) 
} 
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vst_rotation () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Set graphics text string baseline rotation 

vst_rotation (dev_handle, ang_in) 

INT16 vst_rotation (); 
INT16 dev_handle; 
INT16 ang_in; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

angin 

Requested angle of rotation of character base line. 
to 3600 (tenths of degrees) 

Function vst_rotation returns 
>:0 if angle selected 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine sets the base line rotation of graphic 
text. The entire string of text is rotated (rather 
than each character separately) specified by the 
angle of rotation. 

The angle specification assumes that degrees is 
90 degrees to the right of vertical (east on a 
compass), with angles increasing in the counter- 
clockwise direction. If the desired angle is outside 
of the range (0-3600), then a character baseline of 
degrees is used. 
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Input Functions 



This section describes the input functions. An application 
program obtains graphical input from an operator by controlling 
the activity of one or more logical input devices that deliver 
input values to the program. 

The input class determines the type of logical input value the 
device delivers. The four classes and the values they provide 
are: 

Locator Locator input reports coordinate information from a 
device representing a location on the display surface. 
An example device is a mouse. 

Valuator Valuator input returns scalar values in the range that 
is proportional (0 to 32767) to the valuator position. 
An example device is a control dial. 

Choice Choice input returns an integer value indicating one 
of a set of alternatives. An example device is a set of 
function keys, and the value returned is the function 
key pressed. 

String String input returns text strings from the console 

keyboard. 

The input functions operate in two modes: sample and request. 
In sample mode, the input value (locator, valuator, choice or 
string) is returned immediately. In request mode, the input 
device is activated and waits for the user to terminate the input 
process with a device-specific action. Then the input value is 
returned. For example, a sample locator input returns the 
current location of the graphics cursor immediately. In request 
mode, the location of the graphics cursor is returned when the 
user types an alphanumeric key. 
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TABLE 5-4 


Input Functions 






Function 


Routine 


Description 


Page 


Locator 


vrq_locator 


Input Locator 
(request mode) 


5-104 




vsrnjocator 


Input Locator 
(sample mode) 


5-110 


Valuator 


vrq_valuator 


Input Valuator 
(request mode) 


5-108 




vsm_valuator 


Input Valuator 
(sample mode) 


5-113 


Choice 


vrd_curkeys 


Read Cursor 
Movement Keys 


5-101 




vrq_choice 


Input Choice 
(request mode) 


5-103 




vsm_choice 


Input Choice 
(sample mode) 


5-109 


String 


vrq_string 


Input String 
(request mode) 


5-106 




vsm_string 


Input String 
(sample mode) 


5-111 



5-100 Control Functions 



vrd_curkeys () 



Purpose Read cursor movement keys 

Syntax vrcLcurkeys (dev_handle, input_mode, &direction,&key) 

Data Types INT16 vrd_curkeys (); 
INT16 dev_handle; 
INT16 input_mode; 
INT1 6 direction; 
INT8 key; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

input_mode 

Input mode. 

1 = Request 

2 = Sample 

Output direction 

Direction indicated. 

-1 = No keystroke occurred (sample mode only) 

= Key was pressed, but not a cursor 

movement key 

1 = Down and left 

2 = Down 

3 = Down and right 

4 = Left 

6 = Right 

7 = Up and left 

8 - Up 

9 = Up and right 

key 

Key identification value. 

ASCII Decimal Equivalent value of pressed key. 
-1 if cursor movement key was pressed, or no 
key was pressed. 

Function Function vrd_curkeys returns 

Returns >0 if request successful 

if request unsuccessful 
-1 if error 
Actual error can be retrieved by invoking vq_error. 
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Description This routine determines if a cursor movement 

(arrow) key was pressed and returns the resultant 
direction. It can be used in either the Graphics 
Mode or Cursor Addressing Mode to input user 
cursor movement. 
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vrq_choice () 



Purpose 
Syntax 
Data Types 

Input 



Output 

Function 
Returns 



Description 



Input choice (request mode) 

vrq_choice (devjiandle, ch_in, &ch_out) 

INT16 vrq_choice (); 
INT16 dev_handle; 
INT16ch_in; 
INT16 ch_out; 

devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

ch_in 

Initial choice number. 

ch_out 

Choice number. 

Function vrq_choice returns 
>0 if request successful 
if request unsuccessful 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine activates the choice device associated 
with a specified workstation. You must make a 
selection for the function to terminate. See 
Appendix C for information on the choice device 
for the desired workstation. 

The initial choice number, ch_in, is the value 
returned as the selected choice value if a non- 
choice device button/key is pressed. The initial 
choice number must be a valid value for it to be 
returned when the user does not press a valid 
choice input. 
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vrqjocator () 



Purpose Input locator (request mode) 

Syntax vrqjocator (dev_handle, xy_jn, ink, rubberband, 

echo_handle, xy_out, &terminator) 

Data Types INT16 vrqjocator (); 
INT16 devjiandle; 
INT16 xyjn[2]; 
INT16 ink; 
INT16 rubberband; 
INT16 echojiandle; 
INT16xy_out[2]; 
INT8 terminator; 

Input devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

xy_in[0] 

Initial x-coordinate of locator in NDC units. 

xy_in[l] 

Initial y-coordinate of locator in NDC units. 

ink 

Inking status. 

= off 

1 = on 

If on, a line is drawn between the initial locator 
position and the final locator position, honoring 
the current line attributes, such as color and line 
type. If an invalid status is specified, then inking 
is turned off. 

rubberband 

Rubberbanding status. 

= off 

1 = rubber band line 

2 = rubberband rectangle 

If rubberband line is specified, a line is drawn 
between the initial locator position and the current 
position of the locator device as it is moved. The 
line changes dynamically as the input device 
changes position. When the locator event is 
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Output 



Function 
Returns 



Description 



complete the last rubberband line is removed from 
the display surface. 

If rubberband rectangle is specified, a rectangle is 
drawn using the initial locator position as one 
corner and the current position of the locator 
device as the opposite corner. The rectangle 
changes dynamically as the input device changes 
position. When the locator event is complete the 
last rubberband rectangle is removed from the 
display surface. If an invalid status is specified, 
then rubberbanding is turned off. Rubberbanding 
honors current line attributes, such as color and 
line style. 

echo_handle 

The device handle of the device where the echoed 
output from the input operation will be displayed. 

xy_out[0] 

Final x-coordinate of locator in NDC units. 

xy_out[l] 

Final y-coordinate of locator in NDC units. 

terminator 

Locator terminator. 

For keyboard terminated locator input, this is the 
byte value of the key pressed to terminate input. 
For non-keyboard terminated input (tablet, mouse, 
etc.) valid locator terminators begin with <space> 
and increase from there. For instance, if the puck 
on a tablet has four buttons, the first button may 
generate a <space> as a terminator, the second a 
<!>, the third a <">, and the fourth a <#>. 

Function vrqjocator returns 
>0 if request successful 
if request unsuccessful 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine causes the graphics cursor to be 
displayed on the output echo device until the 
function is terminated. See Appendix C for 
information on the locator device for the desired 
workstation. 
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vrq_string () 



Purpose 
Syntax 

Data Types 



Input 



Output 



Function 
Returns 



Description 



Input string (request mode) 

vrq_string (dev_handle, maxjength, echo_mode, echo_xy, 
string) 

INT16 vrq_string (); 
INT16 devjiandle; 
INT16 maxjength; 
INT16 echo_mode; 
INT16echo_xy[2]; 
INT8 s1ring[ ]; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

maxjength 

Maximum string length. 

echo_mode 

Echo mode. 

= Don't echo input characters 

1 = Echo input characters 

echo_xy[0] 

x-coordinate of echo position in NDC units. 

echo_xy[l] 

y-coordinate of echo position in NDC units. 

string 

Output string. 

Passed as a contiguous stream of bytes. 

Function vrq_string returns 

>0 if request successful (length of string) 
if request unsuccessful 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine activates the keyboard. Any 
characters up to (but not including) the Return 
terminator are returned. Line editing characters 
have their normal effect and can be used if errors 
are made. The maximum string length must be 
>1. This routine terminates when the "maximum 
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length" number of characters or a line terminator 
has been entered. Since strings in C are null- 
terminated, the length of array string must be one 
larger than max_length. 
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vrq_valuator () 



Purpose 
Syntax 
Data Types 

Input 



Output 

Function 
Returns 



Description 



Input valuator (request mode) 

vrq_valuator (devjiandle, val_in, &val_out) 

INT16 vrq_valuator (); 
INT16 dev_handle; 
INT16 vaUn; 
INT16 vaLout; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

val_in 

Initial value. 

val_out 

Output value. 

Function vrq_valuator returns status 
>0 if request successful 
if request unsuccessful 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine activates the valuator device and the 
user sets it to the desired value. When ready, the 
user terminates the process with a device-specific 
action (for example, pushing a function key). See 
Appendix C for information on the valuator device 
for the desired workstation. 
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vsm_choice () 



Purpose Input choice (sample mode) 

Syntax vsm_choice (dev_handle, &ch_out) 

Data Types INT16 vsm_choice (); 
INT16 dev_handle; 
INT16 ch_out; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Output ch_out 

Choice. 

Choice number if sample successful 
if sample unsuccessful 

Function Function vsm_choice returns 

Returns >0 if sample successful 

if sample unsuccessful 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine polls the choice device and if a choice 
was pending, it is returned. See Appendix C for 
information on the choice function for the desired 
workstation. 



Input Functions 5-1 09 



vsmjocator () 



Purpose Input locator (sample mode) 

Syntax vsmjocator (devjiandle, xy_out) 

Data Types INT16 vsmjocator (); 
INT16 devjiandle; 
INT16 xy_out[2]; 

Input devjhandle 

Device handle returned from vjopnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Output xy_out[0] 

Current x-coordinate of locator in NDC units. 

xy_out[l] 

Current y-coordinate of locator in NDC units. 

Function Function vsmjocator returns 

Returns 1 if sample successful 

if sample unsuccessful 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine returns the current position of the 

graphics input cursor without waiting for operator 
interaction. See Appendix C for information on 
the locator device for the desired workstation. 
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vsm_string () 



Purpose Input string (sample mode) 

Syntax vsm_string (dev_handle, max_length, echo, mode, echo_xy, 

string) 

Data Types INT16 vsm_string (); 
INT16 devjiandle; 
INT16 maxjength; 
INT16 echo_mode; 
INT16 echo_xy[2]; 
INT8 string[ ]; 

Input devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

maxjength 

Maximum string length. 

echo_mode 

Echo mode. 

= Don't echo input characters 

1 = Echo input characters 

echo_xy[0] 

x-coordinate of echo position in NDC units. 

echo_xy[l] 

y-coordinate of echo position in NDC units. 

string 

Output string. 

Passed as a contiguous stream of bytes. 

Function vsm_string returns 
>0 if sample successful 

(value = length of string) 
if sample unsuccessful 

(value = characters not available) 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine polls the keyboard of the desired 
device. If there is any pending input, it is 
returned until the queue is empty, a carriage 
return or line feed is encountered or the input 



Output 



Function 
Returns 
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maximum string length is exceeded. The line 
terminators themselves are not returned. See 
Appendix C for information on the string device 
for the desired workstation. Since strings in the C 
language are null-terminated, the length of array 
string must be one larger than maxjength. 
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vsm_valuator () 



Purpose Input valuator (sample mode) 

Syntax vsm_valuator (dev_handle, &val_out) 

Data Types INT16 vsm_valuator (); 
INT16 dev_handle; 
INT16 vaLout; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Output val_out 

Current valuator value, if sample successful. 

Function Function vsm.valuator returns 

Returns >0 if sample successful 

if sample unsuccessful 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine returns the current value of the 
valuator device without waiting for operator 
interaction. See Appendix C for information on 
the valuator device for the desired workstation. 
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Inquiry Functions 



This section describes the inquiry functions provided. These 
routines allow you to inquire on primitive attributes and device 
capabilities. 
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TABLE 5-5 


Inquiry Functions 






Function 


Routine 


Description 


Page 


Device 


vq_chcells 


Inquire Addressable 


5-119 


Capabilities 




Character Cells 




Primitive 


vq_cellarray 


Inquire Cell Array 


5-117 


Attributes 


vq_color 


Inquire Color 
Representation 


5-120 




vqf_attributes 


Inquire Current Fill 
Area Attributes 


5-136 




vql_attributes 


Inquire Current 
Polyline Attributes 


5-134 




vqm_attributes 


Inquire Current 
Polymarker Attributes 


5-135 


Text 


vqa_cell 


Inquire Alpha Text 


5-126 


Attributes 




Cell Location 






vqa_font 


Inquire Alpha Text 
Font Capability 


5-128 




vqa_position 


Inquire Alpha Text 
Position 


5-132 




vqa_length 


Inquire Alpha Text 
String Length 


5-131 




vq_curaddress 


Inquire Current 
Cursor Text Address 


5-121 




vqt_attributes 


Inquire Current 
Graphics Text 
Attributes 


5-133 




vqa_cap 


Inquire Alpha Text 
Capabilities 


5-123 


Errors 


vq_error 


Inquire VDI Error 


5-122 
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vq_cellarray () 



Purpose Inquire cell array 

Syntax vq_cellarray (devjiandle, xy, rowjength, num_rows, 

&el_per_row, &rows_used, &status, colors) 

Data Types INT16 vq_cellarray (); 
INT16 devjiandle; 
INT16xy[4]; 
INT16 rowjength; 
INT16 num_rows; 
INT16 el_per_row; 
INT16 rows_used; 
INT16 status; 
INT16 colors[row_length * num_rows]; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

xy[0I 

x-coordinate of lower left-hand corner 
in NDC units. 

xy[l] 

y-coordinate of lower left-hand corner 
in NDC units. 

xy[2] 

x-coordinate of upper right-hand corner 
in NDC units. 

xy[3] 

y-coordinate of upper right-hand corner 
in NDC units. 

rowjength 

Length of each row in color index array. 

numjows 

Number of rows in color index array. 

Output el_per_row 

Number of elements used in each row of color 
index array. 

rows_used 

Number of rows used in color index array. 
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Function 
Returns 



Description 



status 

Invalid value flag. 

if no errors 

1 if a color value could not be determined 
for some pixel 

colors 

Color index array (stored one row at a time). 
-1 indicates that a color index could not be 
determined for that particular pixel 

Function vq_cellarray returns error state 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine returns color indices one row at a 
time, starting from the top of the rectangular area, 
proceeding downward. See the Cell Array routine 
for information regarding how the rectangular area 
is divided. 
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vq_chcells () 



Purpose 
Syntax 
Data Types 

Input 
Output 



Function 
Returns 



Description 



Inquire addressable character cells 

vq_chcells (devjiandle, &rows, &columns) 

INT16 vq_chcells (); 
INT16 dev_handle; 
INT16 rows; 
INT16 columns; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

rows 

Number of addressable rows on the screen. 
-1 indicates cursor addressing is not possible. 

columns 

Number of addressable columns on the screen. 
-1 indicates cursor addressing is not possible. 

Function vq_chcells returns error state 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine returns the number of cursor 
addressable columns in a row and the number of 
cursor addressable rows on the screen. It is only 
applicable to CRT devices and is useful for 
determining addressable page size. 
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vq_color () 



Purpose 
Syntax 
Data Types 



Input 



Output 



Function 
Returns 



Description 



Inquire color representation 

vq_color (devjiandle, in_in, set_flag, rgb) 

INT16vq_color(); 
INT16 dev_handle; 
INT16 ind_in; 
INT16 setjlag; 
INT16 rgb[3]; 

devjhandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

ind_in 

Requested color index. 

set_flag 

Set or realized flag. 

= Set (return color values requested) 

1 = Realized (return color values realized 

on device) 

rgb[0] 

Red intensity. 

to 1000 (tenths of percent) 

rgbfl] 

Green intensity. 

to 1000 (tenths of percent) 

rgb[2] 

Blue intensity. 

to 1000 (tenths of percent) 

Function vq_color returns 
2:0 if color index selected 
-1 if error 
Actual error can be retrieved by invoking vq_.error. 

This routine allows inquiry of the color associated 
with a given index. If an index outside of the 
device's capability is requested, the index closest 
to it is used for the inquiry. 
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vq_curaddress () 



Purpose 
Syntax 
Data Types 

Input 
Output 



Function 
Returns 



Description 



Inquire current cursor text address 

vq_curaddress (dev_handle, &row, &column) 

INT16 vq„curaddress (); 
INT16 dev_handle; 
INT16 row; 
INT16 column; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

row 

Row number. 

1 to number of rows 

column 

Column number. 

1 to number of columns 

Function vq_curaddress returns error state 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

When you are in Cursor Addressing Mode, this 
routine returns the current cursor position. It is 
only applicable to CRT devices. 
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vq_error 

Purpose Inquire VDI error 

Data Types INT16 vq_error(); 

Function Function vq_error returns last error encountered. 

Returns if no error 

<0 actual error last encountered 

Description This routine returns the number of the actual error 
last encountered. It is called when the function 
value returned by any other function is -1. See 
Appendix B for the current list of error numbers. 
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vqa_cap () 


Purpose 


Inquire alpha text capabilities 


Syntax 


vqa_cap (devjiandle, alph_cap) 


Data Types 


INT16 vqa_cap (); 
INT16 dev handle; 
INT16 alph_cap[15]; 


Input 


dev_handle 

Device handle returned from v_opnwk. 




Refers to a specific graphics device when multiple 
workstations are open. 


Output 


alph_cap[0] 

Superscript capability flag. 




= no 




1 = yes 




alph_cap[l] 

Subscript capability flag. 




= no 




1 = yes 




alph_cap[2] 

Underline capability flag. 




= no 




1 = yes 




alph_cap[3] 

Overstrike capability flag. 




= no 




1 = yes 




alph_cap[4] 

Number of discrete alpha text sizes. 




where size 2 is larger (occupies more area) 
than size 1, etc. 




At least one size must be present. 




alph_cap[5] 

Discrete size index of the default font. 




This size is dependent on the number of font sizes 




supported. 
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alph_cap[6] 

Character positioning capability flag. 

= Characters positionable on cell boundaries 

only 

1 = Characters positionable on a finer grid than 

a character cell, but not necessarily the same 
grid as graphics. 

alph_cap[7] 

Number of horizontal character cell positions 
across the display surface in the default font. For 
a typical CRT or printer that can only place text on 
cell boundaries, this value is 80. 

alph_cap[8] 

Number of vertical character cell positions down 
the display surface in the default font. This value 
is 24 for a typical CRT and 66 for a typical printer 
that can only place text on cell boundaries. 

alph_cap[9] 

Number of horizontal character cell positions 
represented by distance specified in alph_cap[13]. 
The ratio alph_cap[13]/alph_cap[9] can be used to 
determine the width of a character cell, including 
any roundoff error. 

alph_cap[10] 

Number of vertical character cell positions 
represented by distance specified in alph_cap[14]. 
The ratio alph_cap[14]/alph_cap[10] can be used to 
determine the height of a character cell, including 
any roundoff error. 

alph_cap[ll] 

Number of horizontal alpha text grids represented 
by distance specified in alph_cap[13]. The ratio 
alph_cap[13]/alph_cap[ll] can be used jto 
determine the width of an alpha text grid, 
including roundoff error. 

alph_cap[12] 

Number of vertical alpha text grids represented by 
distance specified in alph_cap[14j. The ratio 
alph_cap[14]/alph_cap[12] can be used to 
determine the height of an alpha text grid, 
including roundoff error. 
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Function 
Returns 



Description 



alph_cap[13] 

Width in NDC units of the number of character 
cells (in the default font) specified in alph_cap[9]. 
This ratio (alph_cap[13]/ alph_cap[9]) can be used 
to determine the width of a character cell, 
including any roundoff error. 

alph_cap[14] 

Height in NDC units of the number of character 
cells (in the default font) specified in alph_cap[10]. 
This ratio (alph_cap[14]/alph_cap[10]) can be used 
to determine the height of a character cell, 
including any roundoff error. 

Function vqa_cap returns error state 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq.error. 

This routine returns information regarding the 
alpha text features of the device, such as 
subscripting, superscripting and default character 
width and height. 
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vqajcell () 



Purpose Inquire alpha text cell location 

Syntax vqa_cell (dev_handle, row, column, &propflag, &x out, 

&y_out) 

Data Types INT16 vqa_cell (); 
INT16 dev_handle; 
INT16 row; 
INT16 column; 
INT16 propflag; 
INT16 x_out; 
INT16 y_out; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

row 

Row number of character cell. 
1 to number of rows 

column 

Column number of character cell. 
1 to number of columns 

Output propflag 

Proportional spacing flag. 

= no 

1 = yes 

If this value is 1, then the size represented by 
x_out and y_out may not represent the selected 
font. This is the case if the desired font is 
proportionally spaced. 

x_out 

x-coordinate of lower left-hand corner of character 
cell in NDC units. Value may not be accurate if 
the proportional spacing flag is set to i, since the 
character cell size is not constant. 

y_out 

y-coordinate of lower left-hand corner of character 
cell in NDC units. Value may not be accurate if 
the proportional spacing flag is set to 1, since the 
character cell size is not constant. 



5-126 Control Functions 



Function 
Returns 



Description 



Function vqa_cell returns 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine returns the Normalized Device 
Coordinates of the lower left-hand corner of the 
character cell position specified, based on the 
current font. This allows text to be positioned in a 
specific column on the output device. Column 1 
implies a x position on the display surface, and 
row 1 implies the maximum y position on the 
display surface. 

This is not applicable if the current font is a 
proportional font since the size of a character cell 
is not constant. 
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vqajont () 

Purpose Inquire alpha text font capability 

Syntax vqa_font (devjiandle, fontjn, sizejn, font_status) 

Data Types INT16 vqa_font (); 
INT16 devjiandle; 
INT16 font_in; 
INT16 sizejn; 
INT16 font_status[7]; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

font_in 

Requested font. 

Fonts 1 to 3 are fixed-space fonts. 

1 — Normal/standard font (default) 

2 = Bold (always provided for printers) 

3 = Italics 

4 = Proportionally spaced normal font 

5 = Proportionally spaced bold 

6 = Proportionally spaced italics 
>6 = Device-dependent 

size_in 

Requested text size. 
1-device maximum 

where size n+1 is larger (occupies more area) 
than size n, etc. 

Output font_status[0] 

Number of horizontal character cell positions 
across the display surface in this font. This is -1 if 
the font selected is a proportional font, since the 
character cell size is not constant. It is if the 
requested font is not available. 

font_status[l] 

Number of vertical character cell positions down 
the display surface in this font. This is if the 
requested font is not available. 
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font_status[2] 

Number of horizontal character cell positions 
represented by the distance specified in 
font_status[5]. This ratio 
(font_status[5]/font_status[2j) can be used to 
determine the width of a character cell, including 
any roundoff error. This is if the requested font 
is not available. 

font_status[3] 

Number of vertical character cell positions 
represented by the distance specified in 
font_status[6]. This ratio 
(font_status[6]/font_status[3j) can be used to 
determine the height of a character cell,including 
any roundoff error. This is if the requested font 
is not available. 

font_status[4] 

Proportional spacing flag. 

= no 

1 = yes 

If this value is 1, then the size represented by 
font_status[5] and font_status[6] may not represent 
the selected font. This is the case if the desired 
font is proportionally spaced. 

font_status[5] 

Width in NDC units of the number of character 
cells (in the selected font) specified in 
font_status[2]. This ratio 
(font_status[5]/font_status[2]) can be used to 
determine the width of a character cell, including 
any roundoff error. This value is not accurate if 
the proportional spacing flag is set to 1, since the 
character cell size is not constant. It is if the font 
is not available. 

font_status[6] 

Height in NDC units of the number of character 
cells (in the selected font) specified in 
font_status[3]. This ratio 
(font_status[6]/font_status[3]) can be used to 
determine the height of a character cell, including 
any roundoff error. It is if the font is not 
available. 
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Function Function vqajont returns 

Returns >0 if font and size available 

if font and size not available 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine inquires the attributes of a particular 
alpha text font and size, such as availability on 
this device and height and width. 

It can be used to determine the font which best fits 
specific size requirements without having to alter - 
the currently set text font. 
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vqajength () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Inquire alpha text string length 

vqajength (devjiandle, string) 

INT1 6 vqajength (); 
INT16 devjiandle; 
INT8 strlng[]; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

string 

Text string. 

Passed as a contiguous stream of bytes. All control 
characters (ASCII to 31) are ignored and not taken 
into account in computing the length. 

Function vqajength returns 
^0 if string length in NDC units 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine returns the length of the text string 
specified in NDC units, based on the current font 
in use. If a control character (ASCII 0-31) appears 
in the string, it terminates the string length, and 
the string length up to that point is returned. 

This routine is useful when using proportional 
fonts since each character is not the same width. 
It is also useful for doing microjustification 
between words since multiplication of the width of 
a character cell in NDC space may produce 
inaccurate results due to the inherent roundoff 
error in the character cell size reported back to 
the User. 
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vqa_position () 



Purpose Inquire alpha text position 

Syntax vqa_position (dev_handle, &x_out, &y_out) 

Data Types INT16 vqa position (); 
INT16 dev_handle; 
INT16 x_out; 
INT16 y_out; 

Input dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

Output x_out 

x-coordinate of text position in NDC units. 

y_out 

y-coordinate of text position in NDC units. 

Function Function vqa_position returns 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine reports the current alpha text position 
(returned in 0-32767 NDC units). It is assumed 
that (0,0) is at the lower left-hand corner of the 
display surface. 
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vqf_attributes () 



Purpose 
Syntax 
Data Types 

Input 



Output 



Function 
Returns 



Description 



Inquire current fill area attributes 

vqf_attributes (dev_handle, attrib) 

INT16 vqf_attributes (); 
INT16 dev_handle; 
INT16 attrib[4]; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

attrib[0] 

Current fill area interior style. 

= HOLLOW 

1 = SOLID 

2 = PATTERN 

3 = HATCH 

attribll] 

Current fill area color index. 

attrib[2] 

Current fill area style index. 

1 = Narrow spaced +45 degree lines 

2 = Medium spaced +45 degree lines 

3 = Widely spaced +45 degree lines 

4 = Narrow spaced +45 & -45 degree lines 

5 = Medium spaced +45 & -45 degree lines 

6 = Widely spaced +45 & -45 degree lines 
>6 = Device-dependent 

attrib[3] 

Current writing mode. 

(See Set Writing Mode function for description) 

Function vqf .attributes returns 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

Reports current setting of all attributes that affect 
filled areas, bars, pie slices and circles, including 
interior style, fill color and fill style index. 
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vqLattributes () 



Purpose 
Syntax 
Data Types 

Input 



Output 



Function 
Returns 



UCOU1L/UU11 



Inquire current polyline attributes 

vqLattributes (devjiandle, attrib) 

INT16 vqLattributes (); 
1NT16 devjiandle; 
INT16 attrib[4]; 

devjiandle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

attribro] 

Current polyline line type. 

1 = Solid 

2 = Long dashed 

3 = Dotted 

4 = Dashed-dotted 

5 = Medium dashed 

6 = Dashed with two dots 
>6 = Device-dependent 

attrib[l] 

Current polyline line color index. 

attrib[2] 

Current writing mode. 

(See Set Writing Mode function for description.) 

attrib[3] 

Current line width in NDC units. 

Function vqLattributes returns 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq„error. 

T1_'^. l: _ ..t_ iA . i.i :.__ _ <- _ii 
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attributes that affect polylines and arcs, such as 
line type, line color, line width and writing mode. 
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vqm.attributes () 



Purpose 
Syntax 
Data Types 

Input 



Output 



Description 



Inquire current polymarker attributes 

vqm_attributes (devjiandle, attrib) 

INT16 vqm_attributes (); 
INT16 devjiandle; 
INT16 attrib[4]; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

attrib[0] 

Current polymarker marker type. 

1 = . 

2 = + 

3 = * 

4 = O 

5 = X 

6 = Diamond 

>6 = Device-dependent 

attribll] 

Current polymarker marker color index. 

attrib[2] 

Current writing mode. 

(See Set Writing Mode function for description.) 

attrib[3] 

Current polymarker height in NDC units. 
if no error 
-1 if error 
Actual error can be retrieved by invoking vq_error. 

This routine reports the current setting of all 
attributes that affect polymarkers, such as marker 
type, marker color and marker height. 
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vqt_attributes () 



Purpose 
Syntax 
Data Types 

Input 



Output 



Inquire current graphics text attributes 

vqt_attributes (dev _handle, attrib) 

INT16 vqt_attributes (); 
INT16 dev_handle; 
INT16 a«rib[10]; 

dev_handle 

Device handle returned from v_opnwk. 

Refers to a specific graphics device when multiple 

workstations are open. 

attribfO] 

Current graphics text font. 

attrib[l] 

Current graphics text color. 

attrib[2] 

Current angle of rotation of text base line. 
to 3600 (tenths of degrees) 

attrib[3] 

Current horizontal alignment. 

= Left justified (default) 

1 = Center justified 

2 = Right justified 

attrib[4] 

Current vertical alignment. 
2 = Top justified 
1 = Center justified 
= Bottom justified (default) 

attrib[5] 

Current writing mode. 

(See Set Writing Mode function for description.) 

attrib[6] 

Current character width in NDC units. 

attrib[7] 

Current character height in NDC units. 

attrib[8] 

Current character cell width in NDC units. 
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attrib[9] 

Current character cell height in NDC units. 

Function Function vqt_attributes returns 

Returns if no error 

-1 if error 
Actual error can be retrieved by invoking vq_error. 

Description This routine reports the current setting of all 

attributes that affect graphics text, such as text 
size, text color, text font and text rotation. 
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Input/Output Functions 



This section covers character and file I/O functions. Though 
these routines are not required in a graphics program, we have 
included them to insure computer independence for your 
programs. 

All graphics calls are functions that return an integer value which 
may be the error status or other requested information. 

The Open Workstation call initializes a device and returns a 
"device handle," an integer number used to refer to that device. 
All other calls require the device handle as an input argument to 
identify the object device. 
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Communications (Port) I/O 

Character I/O (cm) functions always return status. The status is 
in a 16-bit word where bit is the least significant bit and bit 15 
is the most significant bit. Not all cm functions return all the 
status fields. The fields that a function returns are noted in the 
descriptions of the individual functions. 



Ut(s) 

15 


Meaning 

Error 


Yes 

1 


No 



14 
13 
12 
11 
10 


Always reset to 
Always reset to 
Receive ready 
Transmit ready 
EOF 


1 
1 
1 







9 


Comm initialized 


1 





8 

7 
6 


(Unused) 
Framing error 
Overrun error 


1 
1 






5 
0-4 


Parity error 

Lower five bits of VDI error codes 


1 






The high bit ON (bit 15 set to 1) indicates that an error has 
occurred. The lower five bits of such a negative return function 
value correspond to one of the VDI error codes listed in 
Appendix B, "Error Codes." 
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Disk I/O 

The disk I/O (fd) functions treat a file as a linear sequence of 
bytes. The length of the file is the number of bytes in the file. 
There is a current file position associated with each open file 
which is the next byte to be read or written in the file. 

Each read/write operation implicitly advances the current file 
position forward by the number of bytes read/written. A seek 
operation is provided to set the current file position without 
reading or writing any bytes. A directory is an area in which a 
file resides. It is specified as a null-terminated string of bytes. 
The syntax is dependent on the operating environment. 

A file name is specified as a null-terminated string of bytes. The 
syntax is dependent on the operating environment. A fully 
qualified file name consists of a directory and simple file name. 
All file operations take a file descriptor (fd) as an argument. This 
descriptor is used to identify a connection to a directory or file. 
A maximum of sixteen file descriptors (fd's), open files, may 
exist at one time. There may be a maximum of eighty characters 
in a fully qualified file name. 

Unless otherwise stated (as in fd_parse), directories may be 
specified relative to the current directory or be fully qualified 
(with a leading slash). 

VDI error codes contain both generic and system-dependent 
information based on the following rules: 

□ A negative return from a function always implies an error. 

□ An error return greater than or equal to zero indicates that no 
error occurred. 

o The generic part of the code is of the form-XXOO 

□ The system-dependent part of the code is of the form-OOYY 
Error codes are listed in Appendix B, "Error Codes." 
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TABLE 5-6 


Input/Output Functions 




Function 


Routine 


Description 


Page 


Character I/O cm_start 


Initialize I/O 


5-146 






System 






cm_stop 


Close I/O System 


5-147 




cm_open 


Initialize 
Logical Channel 


5-145 




cm_close 


Close Logical 
Channel 


5-143 




cm_inq 


Inquire Status 
of Channel 


5-144 




cmrx_wait 


Read Character 
From Channel 
With Wait 


5-149 




cmrx_now 


Read Character 
From Channel 
Without Wait 


5-148 




cmtx_wait 


Send Character 
With Wait 


5-151 




cmtx_now 


Send Character 
Without Wait 


5-150 


File I/O 


fd_connect 


Connect Directory 


5-153 




fd_disconnect 


Disconnect Directory 


5-157 




fd_copy 


Copy Directory 


5-154 




fd_open 


Open File 


5-159 




fd_close 


Close File 


5-152 




fd_read 


Read File Wait 


5-161 




fd_write 


Write File Wait 


5-165 




fdp_read 


Read File Proceed 


5-166 




fdp_write 


Write File Proceed 


5-167 




fd_inq 


Inquire File Status 


5-158 




fd_seek 


Seek File 


5-163 




fd_size 


File Size 


5-164 




fd_delete 


Delete File 


5-155 




fd_rename 


Rename File 


5-161 




fd_directory 


Read Directory 


5-156 




fd_parse 


Parse File Name 


5-160 
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cm_close () 



Purpose 
Syntax 
Data Types 

Input 

Function 
Returns 

Description 



Close logical channel 

cm_close (channel) 

INT16 cm_close(); 
INT16 channel; 

channel 

Logical channel number. 

Function cm_close returns status of operation. 

This routine flushes the output buffer associated 
with the I/O channel and marks the logical 
channel as uninitialized. Default parameters will 
be reset to their original values (prior to being set 
by cm_open). Bits 15, 9 and 0-4 are valid in the 
returned status. 
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crnjnq () 



Purpose 
Syntax 
Data Types 

Input 

Function 
Returns 

Description 



Inquire status of channel 

cmjnq (channel) 

INT16 cmjnq (); 
INT16 channel; 

channel 

Logical channel number. 

Function crnjnq returns status of operation. 

This routine returns the status of the specified 
channel. All fields are valid except bits 5-7. If bit 
11 is 1 and you attempt to send a character, the 
write will be successful. If bit 12 is 1 and you 
attempt to read a character, the read will be 
successful. 
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cm_open () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 

Description 



Initialize logical channel 

cm.open (channel) 

INT16 cm_open (); 
INT16 channel; 

channel 

Logical channel number. 

= Alpha console/CRT 

1 = Graphics CRT 

2 = Printer 

3 = Plotter 

4 = Messages 

5 = Host communications 

6 = Auxiliary graphics input 

Function cm_open returns status of operation. 

This routine performs the environment-dependent 
actions necessary to prepare the logical channel for 
input/output. Baud rate, stop bits, and parity 
must be set by the user through standard 
operating system commands prior to using the 
channel. All other terminal port parameters will 
be set as required by GSS-DRIVERS. Sixteen 
logical channels are provided to allow for 
expansion. In practice, many logical channels may 
map the same physical channel. All fields are 
valid in the returned status. 

These routines may be nested but the opened 
channels must be closed in the reverse order to the 
order in which they were opened. Failure to close 
channels in this reverse order may result in 
parameters being reset to incorrect values. 
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cm_start 

Purpose Initialize I/O system 

Data Types INT16 cm_start (); 

Function Function cm_start returns status of operation. 

Returns 

Description This routine performs the actions necessary to 
start the I/O system, such as setting all logical 
channels to the uninitialized state. Bits 15, 9 and 
0-4 are valid in the returned status. 
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cm_stop 

Purpose Close I/O system 

Data Types INT16 cm_stop (); 

Function Function cm_stop returns status of operation. 

Returns 

Description This routine flushes all output buffers associated 
with all I/O channels. Default parameters will be 
reset to their original values (prior to being set by 
cm_open). Bits 15, 9 and 0-4 are valid in the 
returned status. 
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cmrx_now () 

Purpose Read character from channel without wait 

Syntax cmrx_now (channel, &cp) 

Data Types INT16 cmrx_now (); 
1NT16 channel; 
INT8 cp; 

Input channel 

Logical channel number. 

Output cp 

Character read. 

Function Function cmrx_now returns status of operation. 

Returns 

Description If a character is available on the specified channel, 
this routine places it in the byte pointed to by the 
second parameter. Bits 15, 12, 10, 9 and 0-7 are 
valid in the returned status. 
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cmrx_wait () 



Purpose Read character from channel with wait 

Syntax cmrx_wait (channel, &cp) 

Data Types INT16 cmrx_wait (); 
INT16 channel; 
INT8 cp; 

Input channel 

Logical channel number. 

Output cp 

Character read. 

Function Function cmrx_wait returns status of operation. 

Returns 

Description This routine waits until a character has been 

received on the specified channel and then places 
it in the byte pointed to by the second parameter. 
Bits 15, 12, 10, 9 and 0-7 are valid in the returned 
status. 
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cmtx_now () 



Purpose Send character without wait 

Syntax cmtx_now (channel, c) 

Data Types INT16 cmtx_now (); 
1NT16 channel; 
INT8 c; 

Input channel 

Logical channel number. 



Function 
Returns 

Description 



Character sent. 

Function cmtx_now returns status of operation. 

If the specified channel is ready, then this routine 
sends the character specified as the second 
parameter. If a no-wait function is not available 
on the channel, then this routine is identical to 
Send Character With Wait. Bits 15, 12, 9 and 0-4 
are valid in the returned status. 
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cmtx_wait () 



Purpose Send character with wait 

Syntax cmtx_wait (channel, c) 

Data Types INT16 cmtx_wait (); 
INT16 channel; 
INT8 c; 

Input channel 

Logical channel number. 



Function 
Returns 

Description 



Character sent. 

Function cmtx_wait returns status of operation. 

This routine waits until the specified channel is 
ready, then sends a character specified as the 
second parameter. Bits 15, 12, 9 and 0-4 are valid 
in the returned status. 
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fd_close () 



Purpose Close file 

Syntax fd_close (fd) 

Data Types INT16 fd_close (); 
FDfd; 

Input fd 

File descriptor. 

Function Function fd_close returns status of operation. 

Returns <0 if error 

-6YY if unable to close the file associated with 
the fd. 

Description This routine closes the file specified by the input 
file descriptor. This includes writing any pending 
data buffers to disk. The directory associated with 
that fd is the one associated with the fd_connect 
call. The file descriptor remains active until 
fd_disconnect is called. 
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fcLconnect () 



Purpose 


Connect directory 


Syntax 


fd_connect (directory) 


Data Types 


FD fd_connect (); 
INT8 directory! ]; 


Input 


directory 

Directory name, 
string 


Function 
Returns 


Function fd_connect returns status of operation. 



>0 if fd associated with the directory 
<0 if error 
-2YY if unable to connect to directory 

Description This routine returns a file descriptor that is 

associated with the specified directory. This must 
be done before a file can be opened and any I/O 
operations performed. Note that the current 
working directory can be specified with a null 
string ("") or a dot (.). The string cannot exceed 
eighty characters. Additional characters beyond 
eighty will be truncated. 
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fd_copy () 



Purpose 


Copy directory 


Syntax 


fd_copy (fd) 


Data Types 


FD fd copy (); 
FDfd; 


Input 


fd 

File descriptor. 


Function 
Returns 


Function fd_copy returns status of operation. 

<0 if error 
-4YY if unable to create a new fd 


Description 


This routine returns a unique file descriptor 



associated with the same directory of the file 
descriptor specified. If the fd is connected to a 
file, the function returns an error. 
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fd_delete () 



Purpose Delete file 

Syntax fcLdelete (fd, name) 

Data Types INT16 fd_delete (); 
FDfd; 
INT8 name[ ]; 

Input fd 

File descriptor. 

name 

File name. 

Function Function fd_delete returns status of operation. 

Returns <0 if error 

-14YY if unable to delete file 

Description This routine deletes the file specified. The full 

path name (directory name plus file name) cannot 
exceed eighty characters. 
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fcLdirectory () 



Purpose Read directory 

Syntax fcLdirectory (fd, name, buffer, space_available) 

Data Types INT16 fd_directory (); 
FDfd; 

INT8 name[ ]; 
INT8 buffer[ ]; 
INT16 space_availabie; 

Input fd 

File descriptor. 

name 

File name qualifier. 

space_available 

Number of bytes available in buffer. 

Output buffer 

Directory buffer location. 

Function Function fd_directory returns amount of space 

Returns used to hold both directory name and file name. 

Space needed is returned if space needed is 
greater than space available. (Only space 
available bytes of buffer were filled.) 
-16YY returned if unable to get directory 
list on fd 

Description This function returns the names of all files 

matching the specified name in the directory 
associated with the specified fd. File names are 
specified as null-terminated byte strings which are 
placed in the buffer. Input name descriptions are 
specified as null-terminated byte strings. 
Wildcards are allowed in input name descriptions: 

* matches any string of characters in name 
? matches any individual character in name 

A null name specifies that the names of all files in 
the directory are to be returned. The end of the 
buffer is marked be an additional null following 
the final name/null entry. 
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fd_disconnect () 



Purpose Disconnect directory 

Syntax fcLdisconnect (fd) 

Data Types INT16 fd_disconnect (); 
FDfd; 

Input fd 

File descriptor. 

Function Function fd_disconnect returns status of operation. 

Returns <0 if error 

-300 if unable to disconnect the fd 

Description This routine disassociates the specified fd from a 
directory. 



Input/Output Functions 5-157 



fdjnq () 



Purpose Inquire file status 

Syntax fd_inq (fd) 

Data Types INT16 fcUnq (); 
FDfd; 

Input fd 

File descriptor. 

Function Function fdjnq returns status of operation. 

Returns ^0 if number of bytes read/written by the last 

fdp_read or fdp_write. 
-11 YY if unable to get read/write status for the 

fd. 

Description This routine returns the number of bytes read or 
written by the last fdp_read or fdp_write routine, 
unless an illegal fd is specified in which case it 
returns an error. 
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fd_open () 



Purpose Open file 

Syntax fcLopen (fd, name, mode) 

Data Types INT16 fd_open (); 
FDfd; 

INT8 name[ ]; 
INT16 mode; 

Input fd 

File descriptor. 

name 

File name. 

mode 

Access mode. 

Function Function fd_open returns status of operation. 

Returns -5YY if unable to open the requested file. 

Description This routine opens the specified file in the 

directory associated with the specified fd. The file 
descriptor (fd) will be ignored if the file name 
(name) is fully qualified. Mode is a 16-bit word 
where bit is the least significant and bit 15 is the 
most significant bit. 

Bit Meaning 

Read access 

= no 

1 = yes 

1 Write access 

= no 

1 = yes 

2 ASCII/binary flag 

= ASCII text 

1 = Binary (8-bit) data 

The current file position is initialized to 0, that is, 
before the first byte of the file. 
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fd_parse () 



Purpose Parse file name 

Syntax fcLparse (qualified_name, buffer, space_available) 

Data Types INT16 fd_parse (); 

INT8 qualified_name[ ]; 

INT8 buffer[ ]; 

INT16 space_available; 

Input qualified_name 

Fully qualified file name to be parsed. 

Output buffer 

Parsing buffer location. 

space_available 

Buffer space available (size). 

Function Function fd_parse returns amount of space used to 

Returns hold both the directory name and file name. If 

space needed is greater than the space available, 
then space needed is returned. (Only space 
available bytes of the buffer are filled.) 

Description This routine returns the directory and name 

portions of a fully qualified file name. The buffer 
contains two null-terminated byte strings 
(directory and file name). This routine is useful 
for separating the directory from the file name. 
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fd_read () 



Purpose Read file wait 

Syntax fd_read (fd, buffer, count) 

Data Types INT16 fd_read (); 
FDfd; 

INT8buffer[]; 
INT16count; 

Input fd 

File descriptor. 

count 

Desired number of bytes. 

Output buffer 

Read buffer location. 

Function Function fd_read returns number of bytes read. 

Returns <0 if error 

-7YY if error reading file 

Description This routine reads the specified number of bytes 
from the file associated with the specified file 
descriptor, starting at the current file position. It 
returns the number of bytes actually read and 
increments the current file position by the number 
of bytes read. If the number of bytes requested is 
greater than the number of bytes currently in the 
buffer, all bytes in the buffer will be returned. If 
the file position is at end of file, then the routine 
reports that zero bytes were read. 
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fdLrename () 



Purpose Rename file 

Syntax fd_rename (fd, old_name, new_name) 

Data Types INT16 fd_rename (); 
FDfd; 

INT8 old_name[]; 
INT8 new_name[ ]; 

Input fd 

File descriptor. 

old_name 

Old file name. 

new_name 

New file name. 

Function Function fd_rename returns status of operation. 

Returns <0 if error 

-15YY if unable to rename file 

Description This routine changes the name of file old_name to 
be new name. 
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fcLseek () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Seek file 

fcLseek (fd, position, offset) 

INT32 fcLseek (); 
FD fd; 

(NT32 position; 
INT16 offset; 

fd 

File descriptor. 

position 

Specifies new file position. 

offset 

Offset mode. 

= Absolute 

1 = Relative 

Function fcLseek returns status of operation. 

>0 if updated position 

<0 if error 
-12YY if unable to seek on requested fd 

This routine sets the current file position of the file 
associated with fd to the position specified in the 
position argument. The position may be specified 
either as an absolute offset from the beginning of 
the file (offset = 0) or an offset relative to the 
current position (offset = 1). Both the position 
requested and the updated position are long 
integers (32 bits). 
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fcLsize (fd) 



Purpose File size 

Syntax fcLsize (fd) 

Data Types INT32 fcLsize (); 
FDfd; 

Input fd 

File descriptor. 

Function Function fd_size returns status of operation. 

Returns The size returned is a long integer (32 bits): 

>0 if file size in bytes 
<0 if error 
-13YY if unable to determine file size on 
requested fd. 

Description This routine returns the current length of the file 
associated with the specified file descriptor in 
bytes. This value can be used to set the file 
position to the end of the file and append to the 
file. To obtain the size of an open file, first call 
fd close to close the file. 
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fd_write () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Write file wait 

fd_write (fd, buffer, count) 

INT16fcLwrite(); 

FDfd; 

INT8 buffer! ]; 

INT16 count; 

fd 

File descriptor. 

buffer 

Write buffer location. 

count 

Desired number of bytes. 

Function fd_write returns actual number of bytes 
written. 

<0 if error 
-10YY if error writing file 

This routine writes the specified number of bytes 
to the file associated with the specified file 
descriptor, starting at the current file position. It 
returns the number of bytes actually written and 
increments the current file position by the number 
of bytes written. 



Input/Output Functions 5-165 



fdp_read () 



Purpose Read file proceed 

Syntax fdp^read (fd, buffer, count) 

Data Types INT16 fdp_read (); 
FDfd; 

INT8 buffer[ J; 
INT16 count; 

Input fd 

File descriptor. 

count 

Desired number of bytes. 

Output buffer 

Read buffer location. 

Function Function fdp_read returns status. 

Returns >0 if number of bytes read 

if read operation in progress 
-7YY if error reading file 

Description This routine reads the specified number of bytes 
from the file associated with the specified file 
descriptor, starting at the current file position. It 
increments the current file position by the number 
of bytes read. This routine does not wait for the 
read to be complete to return. The Inquire File 
Status routine can be used to determine if file 
operation has been completed. This operation is 
the same as a Read File. 
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fdp_write () 



Purpose 
Syntax 
Data Types 

Input 



Function 
Returns 



Description 



Write file proceed 

fdp_write (fd, buffer, count) 

INT16fdp_write(); 

FDfd; 

INT8 buffer[ ]; 

INT16 count; 

fd 

File descriptor. 

buffer 

Write buffer location. 

count 

Desired number of bytes. 

Function fdp_write returns status. 
>0 if number of bytes written 
if write operation in progress 
-8YY if unable to write to requested file 

This routine writes the specified number of bytes 
to the file associated with the specified file 
descriptor, starting at the current file position. It 
increments the current file position by the number 
of bytes written. This routine does not wait for 
the write to be complete to return. The Inquire 
File Status routine can be used to determine if file 
operation has been completed. This operation is 
the same as a Write File. 
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Glossary 



ADE 



Argument 



Array 



Aspects of 
Primitives 



Attribute Functions 



Binding 



Cartesian 
Coordinate System 



ASCII Decimal Equivalents are decimal 
numbers used in code to represent ASCII 
characters. Examples are 65=A, 66=B. 
ADE character parameters are passed and 
returned as integers. 

One of the independent variables that the 
action or output of a routine depends on. 
Arguments are enclosed in parentheses 
in the routine call. 

Series of related items (data) arranged in 
a meaningful pattern. 

Ways in which the appearance of a 
primitive can vary. Aspects are 
controlled directly by primitive attributes. 

Primitive attributes affect the appearance 
of objects created with primitive 
functions. (Examples: character height, 
line style) 

Language binding refers to the exact 
calling syntax and data type specification 
for arguments to be used when calling 
GSS-DRIVERS routines from a specific 
programming language. 

Coordinate system composed of an X-axis 
(horizontal) increasing positively towards 
the right, and a Y-axis (vertical) 
increasing positively upwards. The axes 
are positioned at right angles, and the 
point of intersection is the origin (0., 0.). 
The position of any point is defined by 
the displacement from the origin along 
first the X- and then the Y-axis. 
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Cell Array 



GSS-DRIVERS output primitive consisting 
of a rectangular grid of equal size 
rectangular cells, each having a single 
color. 



Choice Input Device 



Clipping 



Color Map 



Color Table 



Coordinate Graphics 



Note 

These cells may not map one-to-one with 
frame buffer pixels. 

A logical input device that offers the user 
a set of alternatives and returns an 
integer value indication of the option 
selected. An example device is a set of 
function keys. 

When you set a window in the world 
coordinate space, part of an object may 
lie outside the window. In this case, the 
part lying outside the window will be 
clipped; that is, it will not be projected 
onto the viewport. 

Table designed to provide a range of 
colors by defining different mixtures of 
the color components. A desired color is 
referenced by its assigned number. The 
identifying numbers with their assigned 
colors are called the color map. 
Changing colors assigned to the 
identifying number changes the map. 

Workstation-dependent table in which 
the entries specify the values of the red, 
green and blue intensities defining a 
particular color. Control Functions 
These facilities allow you to exercise 
control over certain aspects of the system 
and the display device. GSS-DRIVERS 



jr" 






standard capabilities of your display 
device through an escape mechanism 
invoked with the escape function. 

Computer graphics in which display 
images are generated from display 
commands and coordinate data. 
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Coordinate Scaling 



Default 

Device Coordinate 
Device Driver 

Device Handle 
Device-Independent 
Device Space 
Display Device 

Display Surface 
Echo 

Environmentals 



Coordinate scaling transforms points 
from one "space" to another. In 
GSS-DRIVERS all point coordinates must 
be specified in Normalized Device 
Coordinates with values between and 
32767. These coordinates are then scaled 
into values which are appropriate for 
your graphics device. 

A value assigned to a parameter by 
GSS-DRIVERS and used when you do not 
specify a value. 

A coordinate expressed in a coordinate 
system that is device-dependent. 

Device-dependent software that 
generates instructions specifying items to 
be drawn on the display surface from the 
invocations of GSS-DRIVERS. 

Number returned that represents a 
unique device. 

The ability to be used on more than one 
type of graphics display device. 

The space defined by the addressable 
points of a display device. 

A device (for example, refresh display, 
storage tube display, plotter) on which 
display images can be represented. 

In a display device, that medium on 
which display images may appear. 

The immediate notification of the current 
value provided by an input device to the 
operator at the display console. 

Environmentals are attributes, selected by 
the programmer, that affect the 
appearance of some aspect of the 
displayed graph. For example, there is a 
call to set the line type for polyline 
output. Environmentals have default 
values which are in effect after 
initialization of GSS-DRIVERS. If the 
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Escape 



Fill Area 



Generalized 
Drawing Primitive 
(GDP) 

GKS 

Graphical Kernel 
System 

Graphics Primitives 



GSS-DRIVERS 



Host-Independent 
Input Functions 



programmer alters an environmental, it 
retains its new value until it is changed 
by another attribute call or GSS-DRIVERS 
is reinitialized. 

A function within GSS-DRIVERS which is 
the only access to implementation- 
dependent or device-dependent support 
for nonstandard functionality other than 
graphics output. 

A GSS-DRIVERS output primitive 
consisting of a polygon (closed boundary) 
which may be hollow or may be filled 
with a uniform color, a pattern, or a 
hatch style. 

A display element (output primitive) 
used to address special geometrical 
workstation capabilities such as curve 
drawing. 

Graphical Kernel System. 

The Graphical Kernel System (GKS) is an 
international standard for the 
programmer's interface to graphics. 

Graphics primitives are the basic graphics 
operations performed by GSS-DRIVERS; 
for example, drawing lines, markers and 
text strings. 

GSS-DRIVERS is a host- and device- 
independent graphics subsystem that 
serves as an environment for graphics 
applications as well as application 
development. 

Capable of running on a number of 
operating systems. 

GSS-DRIVERS allows you to obtain the 
value of an NDC point from an 
interactive graphics device. The method 
for specifying the point is device- 
dependent. 
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Inquiry Functions 



Integer 
I/O System 

Locator Input Device 



NDC 

Normalized Device 
Coordinate Space 



Normalized Device 
Coordinates 



GSS-DRIVERS provides inquiry facilities 
that allow your program to determine the 
present state of the system. You may 
determine the current value of the 
following: 

n primitive attributes 

n device capabilities 

□ device state 

A whole number; that is, a number with 
no fractional part. 

Host-dependent part of GSS-DRIVERS 
which allows GSS-DRIVERS to 
communicate with your graphics devices 
using the standard host hardware. 

A GSS-DRIVERS logical input device 
providing a position in world coordinates 
and a normalization transformation 
number. Examples include cursors, mice 
and joysticks. 

Normalized Device Coordinates. 

Normalized Device Coordinate Space is a 
uniform virtual space by which a 
graphics application program passes 
graphics information to a device. 
GSS-DRIVERS translates between NDC 
space and the display coordinates of a 
particular device. 

GSS-DRIVERS introduces the concept of a 
Normalized Device Coordinate (NDC) 
Space in which the full extent of the 
device axes are assigned values between 
and 32767. This convention provides 
improved device independence for a 
graphics system by allowing the viewing 
operations to be carried out without 
regard for device coordinate specifics. 
The NDC coordinates are then converted 
to specific device coordinates by 
GSS-DRIVERS. 
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Null-Terminated 
String 

Output Primitives 



Pixel 

Polyline 
Polymarker 

Raster 
Real 



A one-dimensional array or list of 
characters. The end of a string is 
indicated by the NULL character (ADE 0). 

The graphical world which the 
programmer describes consists of one or 
more objects. Objects are created and 
modified by invocations of graphics 
primitive functions provided by 
GSS-DRIVERS. These functions describe 
polylines, polymarkers, text strings, pixel 
arrays, fill areas and generalized drawing 
primitives. The invocation of an output 
primitive function results in an output 
primitive, such as a sequence of markers 
or polylines. The appearance of output 
primitives is affected by the values of 
primitive attributes. 

The smallest element of a display surface 
that can be independently assigned a 
color or intensity. 

A GSS-DRIVERS output primitive 
consisting of a set of connected lines. 

A GSS-DRIVERS output primitive 
consisting of a set of locations to be 
indicated by a marker. 

A field of closely spaced lines on the face 
of a video terminal that defines an image. 
The spacing between raster lines defines 
the resolution of a display. 

A number which contains a fractional 
part expressed as a decimal. For 
example, 23.56. 
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which colors are produced by adding 
percentages of the primaries: 





red 


+ 


green 


+ 


blue 


white = 


100% 


+ 


100% 


+ 


100% 


yellow = 


100% 


+ 


100% 


+ 


0% 


magenta = 


100% 


+ 


0% 


+ 


100% 


cyan = 


0% 


+ 


100% 


+ 


100% 
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Transformation 



Valuator Input 
Device 



VDI 

Virtual Device 
Interface 



Workstation 



The mapping of objects from one 
coordinate space to another. 

A logical input device that returns scalar 
values in the range that is proportional (0 
to 32767) to the valuator position. An 
example device is a control dial. 

Virtual Device Interface. 

The Virtual Device Interface is a standard 
interface between device-dependent and 
device-independent code in a graphics 
environment. VDI makes all device 
drivers appear identical to the calling 
program. GSS-DRIVERS is based on VDI 
and all device drivers written for 
GSS-DRIVERS must conform to the VDI 
specification. 

GSS-DRIVERS is based on the concept of 
abstract graphical workstations which 
provide the logical interface through 
which the applications program controls 
physical devices. 
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Appendices 



C Conventions and Example A-1 

Using the Bindings A-1 

A Note on Binding Conventions A-1 

Programming Example A-2 



B Error Codes 



B-1 



Device-Dependent Information C-1 

Device Information Categories C-2 

AT&T Model 470 Graphics Printer C-4 

AT&T Model 455 Letter Quality Printer C-8 

AT&T UNIX PC Model 7300 Display C-12 
CmOle Terminal™ with CIG-lOle 

Graphics Card™ C-17 
CIT161 Terminal™ with CIG-267 Graphics 

Card™ C-22 

Diablo® C150 InkJet Color Printer C-27 

Epson MX™-100 C-31 

Epson MX-80 with Graphtrax Plus C-35 

Hewlett-Packard 7470A Plotter C-39 

Hewlett-Packard 7475A Plotter C-43 

HIPLOT DMP-29 Plotter® C-47 

NEC Model 7730 Letter Quality Printer C-51 

NEC Model 3550 Letter Quality Printer C-55 
Nicolet Instrument Corporation ZETA™-8 

Plotter C-59 

Okidata Microline™ 93 C-63 

Okidata Microline 84 with Step 2 Support C-63 

Okidata Microline 92 C-67 

Printronix® MVP™ Printer C-71 

Printronix P300 Printer C-71 

Printronix P600 Printer C-71 

Strobe® Model 100— Single pen Plotter C-75 

Strobe Model 200— Single pen Plotter C-75 

Strobe Model 260— Eight pen Plotter C-75 



Summagraphics® Summatablet ™ C-79 

Tektronix™ 4105 Color Graphics Terminal C-81 

Virtual Device Metafile (VDM) C-87 
VT100™ Terminal with Retro-Graphics™ 

Card C-92 



D ASCII Code Chart 



D-1 



Bibliography E-1 



C Conventions and Example 



GSS-DRIVERS C language binding provides an interface between 
VDI-compatible device drivers and your C compiler. This allows 
the programmer to specify graphics operations as subroutine 
calls with the native syntax of the language environment. By 
hiding many of the details of the device-driver interface, the 
language binding eases programming tasks and allows the 
programmer to concentrate on his application. 



Using the Bindings 

The C binding is implemented as a linkable library containing all 
the functions described in Part 5. This library must be included 
in the list of relocatable modules during the linking process. The 
normal operating procedures for your linker should be followed 
when linking GSS-DRIVERS bindings to an application. 



A Note on Binding Conventions 

In the C bindings, INT16 refers to signed 16-bit integers and 
INT8 refers to signed 8-bit integers. FD refers to signed 16-bit 
integers. INT32 refers to long integer (32 bit). Scalar input 
arguments are passed by value; array input arguments are 
passed by address. All output arguments are passed by address. 

All graphics calls are functions that return an integer value which 
may be the error status or other requested information. 

The Open Workstation call initializes a device and returns a 
"device handle," an integer number used to refer to that device. 
All other calls require the device handle as an input argument to 
identify the object device. 
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Programming Example 

The following C programming example accompanies the 
pseudocode in Part 2, producing the Gantt Chart in Figure 2-2. 

/* This is a program to use the VDI C binding to draw a Gantt chart */ 

main() 

{ 

static char *tasks[ ] = {"Full Production", "Evaluation", "One Third", 

"Plant", "Purchasing", 'Tool Design", "Review", "Design"}; 
static char *title = {"Aurora Processing Plant"}; 
static char *y_label = {"As of June 15"}; 
static char *y_ticks[ ] = {"July", "August", "September", "October"}; 

extern box(); 

extern short pto32k(); 

short devjiandle, 
xheight, 
istring[2], 
gdms_err, 
xy[10], 
savary[64], 
xwidth, 
cwidth, 

cheight; 

static short echo_xy[2] = {0,0}; 

static short nominate[ ] = {0, 1 , 1 , 3, 1 , 1 , 1 , 0, 0, 1 , 1 , 
'D', T, 'S', 'P', 'L', 'A', 'Y', ' '}; 

static short start_dates[ ] = {83, 72, 70, 48, 48, 45, 40}; 
static short end_dates[ ] = {95, 83, 79, 75, 67, 60, 49}; 

gdms_err = v_opnwk(nominate,&dev_handle,savary); 

/* nominate the device */ 
xy[1] = pto32k(10); xy[3] = pto32k(80); 

/* set the constants for the grid */ 
for (i=50;i<=80;i+ = 15){ 

xy[0] = pto32k(i); xy[2] = xy[0]; 

/* set variable elements in array for grid */ 
gdms_err = v_pline(dev_handle,2,xy); 
/* draw the line */ 
} 

xheight = vst_height(dev_handle,pto32k(4),&xwidth,&cwidth,&cheight); 

/* set character height */ 
gdms_err = vst_alignment(dev_handle,1,2,&i,&j); 

/* set text alignment */ 
j = 0; 

/* index into tick labels */ 
for(i=43;i<=88;i+ = 15){ 

gdms_err = v_gtext(dev_handle,pto32k(i),pto32k(10),yjicks[ j+ +]); 
/* write text */ 
} 

gdms_err = vst_alignment(dev_handle,2,1,&i,&j); 
/* set text alignment */ 
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j = 0; 

/* index into y axis labels */ 
for(i=15;i<=75;i+=10){ 

gdms_err = v_gtext(dev_handle,pto32k(33),(short) (pto32k(i)-xheight/2.0), 
tasks[ j++]); 
/* write out text */ 

} 
gdms_err = vst_alignment(devjiandle,0,0,&i,&j); 

/* set text alignment */ 
gdms_err = v_gtext(dev_handle,pto32k(35),pto32k(82),y.Jabel); 

/* write out the y axis label */ 
gdms_err = vst_height(dev_handle,pto32k(9),&xwidth,&cwidth,&cheight); 

/* set new character height */ 
gdms_err = v_gtext(dev_handle,pto32k(35),pto32k(88),title); 

/* write out title text */ 

gdms_err = vsf_style(dev_handle,2); 
gdms_err = vsf_lnterior(dev_handle,3); 

/* set fill pattern */ 
j = 0; 

/* set index into data arrays */ 
for (i=12;i<=72;i+=10) { 

xy[1] = pto32k(i); xy[3] = pto32k(i+6); 
xy[0] = pto32k(start_dates[ j]); 
xy[2] = pto32k(end_dates[j++]); 
/* set dimensions for bars */ 
gdms_err = v_bar(dev_handle,xy); 
/* draw the bars */ 
} 
box(35,95,10,80,xy); 

/* create box points */ 
gdms_err = v_pline(dev_handle,5,xy); 
/* draw frame around chart */ 
box(0,1 00,0,1 00,xy); 

/* create page border */ 
gdms_err = v_pline(dev_handle,5,xy); 

/* draw page border */ 
gdms_err = vrq_string(dev_handle,2,0,echo_xy,istring); 

/* wait for <CR> */ 
gdms_err = v_clswk(dev_hand!e); 
} 

box(xmin,xmax,ymin,ymax,xyout) 
short xmin, xmax, ymin, ymax, xyout[ ]; 

{ 

extern short pto32k(); 

xyout[0] = pto32k(xmin); xyout[1] = pto32k(ymin); 

xyout[2] = pto32k(xmax); xyout[3] = xyout[1]; 

xyout[4] = xyout[2]; xyout[5] = pto32k(ymax); 

xyout[6] = xyout[0]; xyout[7] = xyout[5]; 

xyout[8] = xyoutfoj; xyout[9] = xyoutflj; 
} 

short pto32k(percent) 
short percent; 

{ 

return((float) percent / 100.0 * 32767); 

} 
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Error Codes 



This appendix lists the error codes returned by GSS-DRIVERS 
functions. 

GSS-DRIVERS functions always return to the caller whether or 
not the requested operation was successful. Each function 
returns an error status that indicates the results of the request. 
In this way the application program is made aware of the 
condition of the graphics subsystem and can take appropriate 
action without losing control of the system. This also places a 
responsibility for checking error status and attempting error 
recovery, or at least informing the user, on the applications 
program. 

No error messages are displayed on the system console by 
GSS-DRIVERS. 

Error codes contain both generic and system-dependent 
information based on the following conventions: 

□ A negative return from a function always implies an error An 
error return greater than or equal to zero indicates that no 
error occurred. 

□ The error code has two parts: generic and system-dependent. 

□ The generic part of the code is in the form -XX00. 

□ The system-dependent part of the code is in the form OOYY. 

For example error code -1405 indicates: 

-1400 = > error in fd delete error 
-0005 => access denied 
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TABLE B-1 Generic Codes 
Code Cause 

-100 VDI SWAP DRIVER ERROR 

An error has been encountered while swapping device 
drivers. The proper driver may not be resident in the 
specified directory area or the driver name may not be 
included in the system environment. 

-200 FD CONNECT ERROR 

Error during the file connect operation. 

-300 FD DISCONNECT ERROR 

Error during the file disconnect operation. 

-400 FD COPY ERROR 

Error during the copy file descriptor operation. 

-500 FD OPEN ERROR 

Error while opening a file. 

-600 FD CLOSE ERROR 

Error while closing a file. 

-700 FD READ ERROR 

Error while reading a file in wait mode. 

-800 FD WRITE ERROR 

Error while writing to a file in wait mode. 

-900 FDP READ ERROR 

Error while reading file in proceed mode. 

-1000 FDP WRITE ERROR 

Error while writing to a file in proceed mode. 

-1100 FD INQUIRE ERROR 

Error while inquiring about file status. 

-1200 FD SEEK ERROR 

Error during seek operation. 

-1300 FD SIZE ERROR 

Error while inquiring current file size. 

-1400 FD DELETE ERROR 

Error during file delete operation. 

(continued) 
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TABLE B-1 (continued) 
Code Cause 

-1500 FD RENAME ERROR 

Error while renaming a file. 

-1600 FD DIRECTORY ERROR 

Error during directory list operation. 

-1700 FD PARSE ERROR 

Error while parsing filename. 

-1800 EM DASH ERROR 

Error during dash output. 

-1900 EM MARKER ERROR 

Error during marker output. 

-2000 EM ALIGNMENT ERROR 

Error during text alignment output. 

-2100 EM POLYGON ERROR 

Error during polygon output. 

-2200 EM BAR ERROR 

Error during bar output. 

-2300 EM ARC ERROR 

Error during arc output. 

-2400 EM PIE ERROR 

Error during pie output. 

-2500 EM CIRCLE ERROR 

Error during circle output. 

-2600 GIN INIT ERROR 

Error initializing input device. 

-2700 GIN POINT ERROR 

Error moving cursor during GIN. 

-2800 GIN TERMINATOR 

Error terminating GIN function. 

-3000 DEVICE DRIVER ERROR 

Error while calling device driver. 

-5000 NOT CAPABLE ERROR 

Specified device is not capable of requested function. 

Error Codes B-3 



TABLE B-2 Specific Codes 
Code Cause 

-1 INVALID FUNCTION 

Operating system error — invalid function code. 

-2 FILE NOT FOUND 

Operating system error — named fiie not found. 

-3 PATH NOT FOUND 

Operating system error — named path not found. 

-4 TOO MANY OPEN FILES 

Operating system error — too many files open. 

-5 ACCESS DENIED 

Operating system error. Named file not accessible 
(protected). 

-6 INVALID HANDLE 

Operating system error — invalid device handle. 

-8 INSUFFICIENT MEMORY 

Operating system error. Insufficient memory for 
requested operation. 

-16 RM CURRENT DIRECTORY 

Operating system error. Attempt to remove the current 
directory. 

-18 NO MORE FILES 

Operating system error. No more space on device. 

-78 CANT DELETE DIRECTORY 

Attempted to delete a directory. 

-79 DEVICE BUSY 

Device currently in use. 

-80 HARDWARE NOT PRESENT 

Device or hardware not present. 

-81 ALL SLOTS USED 

Cannot open another UNIX driver. 

-82 VDI CANT START 

Cannot get VDI going. 

(continued) 
B-4 Error Codes 



TABLE B-2 (continued) 
Code Cause 

-84 CANT START DRIVER 

Fork of driver failed. 

-85 EOF ERROR 

End of file found. 

-86 ALREADY OPEN 

Open Workstation attempted when workstation already 
open. 

-88 CANNOT START READ FORK 

Reader not executed. 

-89 NO DRIVER FILE 

Filename not found. 

-90 UNKNOWN DRIVER 

Driver file does not exist. 

-92 ILLEGAL HANDLE 

Illegal device handle. 

-94 FD ILLEGAL OFFSET 

Illegal byte offset within file. 

-96 FD NOT CONNECTED 

The file description is not connected. 

-97 FD FILE IS OPEN 

File currently open. 

-98 FD NOT AVAILABLE 

File not available. 

-99 FD NOT DIRECTORY FILE 

File not within current directory. 
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Device-Dependent 
Information 



This appendix contains information about specific graphics 
peripheral devices that are supported by GSS-DRIVERS. It 
describes the capabilities and limitations of devices, the index 
assignments for selectable functions such as polymarker types 
and color, and other special information. 

Specific information is provided for the following devices: 

AT&T Model 470 Graphics Printer C-4 

AT&T Model 455 Letter Quality Printer C-8 

AT&T UNIX PC Model 7300 Display C-12 

CIT-lOle Terminal with CIG-lOle Graphics Card C-17 

CIT-161 Terminal with CIG-267 Graphics Card C-22 

Diablo C150 Ink Jet Color Printer C-27 

Epson MX-100 Printer C-31 

Epson MX-80 Printer with Graphtrax Plus C-35 

Hewlett-Packard 7470A Plotter C-39 

Hewlett-Packard 7475A Plotter C-43 

HIPLOT DMP-29 Plotter C-47 

NEC Model 7730 Letter Quality Printer C-51 

NEC Model 3550 Letter Quality Printer C-55 

Nicolet Zeta Corporation Zeta 8 Plotter C-59 

Okidata Microline 93 and 84 Printer with Step 2 Support C-63 

Okidata Microline 92 Printer C-67 

Printronix Printers C-71 

Strobe Plotters C-75 

Summagraphics Summatablet C-79 

Tektronix 4105 Color Graphics Terminal C-81 

Virtual Device Metafile (VDM) C-87 

VT100 Terminal with Retro-Graphics Card C-92 
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Device Information Categories 



Communications 



Features 
Supported 



The following information is given for each graphics devices: 

File Name The name of the device driver file. 

Device Type The logical name of the device. This name 

must be included as the workstation 
identifier in the Open Workstation call that 
initializes the device. It is also used when 
setting your graphics environment to redefine 
the logical to physical assignments. 

Specific information about the data interface 
to the device such as flagging protocols and 
strapping options. 

Describes the features contained within the 
VDI Specification that are supported on this 
device. Subcategories include: 

Polylines Describes the available line styles 
and their index numbers. 

Graphics Describes the graphics text 
Text capabilities of the device such as 

character size and rotation and 
their index numbers. 

Graphics Describe the marker symbols 
Markers available, their size variations and 
their index numbers. 

Filled Describes the fill styles available 

Areas for area fills and their 

corresponding indices. 

Describes the color capabilities of the device, 
default colors, color selection, color indices 
and color index to pert correspondence in the 
case of plotters. 

Specific information about the operation of 
graphics input such as the operator action 
required to initiate and terminate input. 

Describes the text capabilities of the device 
such as fonts, sizes, color and other 



Color 

Graphics Input 
Alpha Text 
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Request Locator 



Request String 



Raster Writing 

Cursor 

Addressable 

Text 



Special 
Information 



VDI Opcode 
Summary 



attributes. On some devices alpha text is 
distinct from graphics text. 

Describes how the Request Locator function 
is implemented on the device. 

Describes how the Request String function is 
implemented on the device. 

Describes pixel (pel) operations. 

Lists the attributes available to cursor 
addressable text on the device. Cursor text 
attributes include reverse video, underline, 
blink, bold, and color. 

Contains information unique to the device 
which is not described under another 
heading. 

Lists the VDI operations that are supported 
by the device. 
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AT&T Model 470 Graphics Printer 



File Name 
Device Type 
Communications 



Features 
Supported 



att470 

PRINTER 

Parallel 

The standard Centronics parallel cable will 

operate the Model 470 printer properly. 

Polylines Lines and arcs can be drawn with 
the seven line styles listed below: 

1 Solid 

2 Long Dash 

3 Dotted 

4 . . Dash Dotted 

5 Medium Dashed 

6 . . . . Dash Two Dots 



7 Short Dash 

Graphics This printer supports twelve 
Text character sizes with a Preserve 

Aspect Ratio and twelve sizes in 
a Non-preserve Aspect Ratio. 
Note that these graphics text 
characters can be rotated on 0, 
90, 180, and 270 degree base 
lines. 

Graphic The driver supports six kinds of 
Markers Graphic Markers. Each marker 

has five possible sizes in Preserve 
Aspect Ratio and five sizes in 
Non-preserve Aspect Ratio. The 
six kinds of markers are shown in 
the following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 
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Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

Color The Model 470 printer supports two colors: 

Index 1 is displayed in black ink and index 
is not displayed. These colors can not be 
redefined. 

Alpha Text Alpha text can be positioned anywhere on 

the output page. The following text 
capabilities are available on the Model 470 
printer: 

Fonts: 1 = Normal (default) 
2 = Bold 
4 

5 



= Proportional spaced 

= Bold proportional spaced 

Sizes: 1 = 17 characters per inch 

2 = 12 characters per inch 

3 = 10 characters per inch 

4 = 8.5 characters per inch 
5=6 characters per inch 
6=5 characters per inch 

Note 

Text size is ignored when selecting a 
proportional font. 
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Superscript and Subscript 

Underline 

Line Spacing 

Overstrike Mode 

Pass Through Mode 

VDI Opcode The GSS VDI functions available for the 

Summary Model 470 driver include: 

Clear Workstation — Causes picture 

generation; advances paper 
Close Workstation — Causes picture 

generation; resets printer to default state 
Open Workstation — Initializes printer for 

output 
Set Alpha Text Position 
Set Writing Mode — All sixteen Boolean 

writing modes are supported 
Update Workstation — Causes picture 

generation; advances paper; subsequent 

output is overlayed 

Primitives 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array — Outlines the area, no other 

action 
Circle (uses filled area attributes) 
Filled Area 
Graphics Text 
Output Alpha Text 
Output Cursor Addressable Text — Transmits 

string to printer immediately 
Pie Slice (uses filled area attributes) 
Polyline 
Polvnr* 9 rkpr 

Attributes 

Set Alpha Text Color 
Set Alpha Text Font and Size 
Set Alpha Text Line Spacing 
Set Alpha Text Overstrike Mode 
Set Alpha Text Pass Through Mode 
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Set Alpha Text Quality — Returns default 

value 
Set Alpha Text Script Mode 
Set Alpha Text Underline Mode 
Set Graphics Text String Baseline Rotation 
Set Character Height 
Set Color Representation — Returns default 

settings 
Set Fill Color Index 
Set Fill Interior Style 
Set Fill Style Index 
Set Graphics Text Alignment 
Set Graphics Text Color Index 
Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Inquiries 

Inquire Alpha Text Capabilities 

Inquire Alpha Cell Location 

Inquire Alpha Font Availability 

Inquire Alpha Text Position 

Inquire Alpha String Extent 

Inquire Addressable Character Cells — Will 

return (-1, -1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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AT&T Model 455 Letter Quality Printer 



File Name 
Device Type 
Communications 



Features 
Supported 



att455 

PRINTER 

Parallel 

A Centronics standard parallel cable will 

operate the AT&T 455 printer properly. 



Polylines 



Lines and arcs can be drawn with 
the seven line styles listed below: 

Solid 

Long Dash 

Dotted 

. . Dash Dotted 

Medium Dashed 

. . . . Dash Two Dots 



7 Short Dash 

Graphics This printer supports twelve 
Text character sizes with a Preserve 

Aspect Ratio and twelve sizes in 
a Non-preserve Aspect Ratio. 
Note that these graphics text 
characters can be rotated on 0, 
90, 180, and 270 degree base 
lines. 

Graphic The driver supports six kinds of 
Markers Graphic Markers. Each marker 

has five possible sizes in Preserve 
Aspect Ratio and five sizes in 
Non-preserve Aspect Ratio. The 
six kinds of markers are shown in 
the following list: 

i = r>/-».f 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 
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Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

Color The AT&T Model 455 printer supports two 

colors. Index 1 is displayed with the black 
ribbon and index is not displayed. These 
colors cannot be redefined. 

Alpha Text Alpha text can be positioned anywhere on 

the output page. The following text 
capabilities are available on the AT&T 455 
printer: 

Fonts: 1 = Normal (default) 
2 = Bold 

4 = Proportionally spaced 

5 = Bold proportionally spaced 

Sizes: One size supported. 

10 cpi print wheel for constant 
spacing, or a WPS print wheel 
for proportional spacing. 

Superscript and Subscript 

Underline 

Overstrike Mode 

Pass Through Mode 
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Alpha Text Quality: 

<50 : Turn on bi-direction printing 
>50 : Turn off bi-direction printing 

Special Prior to running an application, the constant 

Information spacing print wheel must be installed. When 

a proportionally spaced alpha text font is 
desired, the user will be prompted to place 
the proportional spacing print wheel into the 
AT&T 455. If the alpha text font is later 
changed back to a constant spacing font, the 
user will be prompted to insert it back into 
the printer. Note that changing the print 
wheel will cause the READY light to blink. 
Press the PAUSE button to reactivate the 
printer. 

VDI Opcode The functions available in the GSS VDI for 

Summary the AT&T 455 printer are: 

Clear Workstation — Causes picture 

generation and advances paper 
Close Workstation — Causes picture 

generation 
Open Workstation — Advances the paper 
Set Alpha Text Position 
Set Writing Mode — Mode 4 (replace) and 

mode 8 (overstrike) are supported 
Update Workstation — Causes picture 

generation; subsequent output is overlaid 

Output 

Arc — uses polyline attributes 

Bar — uses filled area attributes 

Cell Array — Outlines the area, no other 

action 
Circle — uses filled area attributes 
Filled Area 



vjiaL»iuc& icai 



Output Alpha Text 

Output Cursor Addressable Text — Transmits 

string to printer immediately 
Pie Slice — uses filled area attributes 
Polyline 
Polymarker 
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Attributes 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode 

Set Alpha Text Quality 

Set Alpha Text Script Mode 

Set Alpha Text Underline Mode 

Set Graphics Text String Baseline Rotation 

Set Character Height 

Set Color Representation — Returns default 

settings 
Set Fill Color Index 
Set Fill Interior Style 
Set Fill Style Index 
Set Graphics Text Alignment 
Set Graphics Text Color Index 
Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Inquiries 

Inquire Alpha Text Capabilities 

Inquire Alpha Cell Location 

Inquire Alpha Font Availability 

Inquire Alpha Text Position 

Inquire Alpha String Extent 

Inquire Addressable Character Cells — Will 

return (-1, -1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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AT&T UNIX PC Model 7300 Display 



File Name 

Device Type 

Features 
Supported 



pc7300 

DISPLAY 

Polylines 



Graphics 
Text 



Graphic 
Markers 



Filled 
Areas 



Lines and arcs can be drawn with 
the seven line styles listed below: 

Solid 

Long Dash 

Dotted 

. . Dash Dotted 

Medium Dashed 

. . . . Dash Two Dots 

Short Dash 

This printer supports five 
character sizes with a Preserve 
Aspect Ratio and five sizes in a 
Non-preserve Aspect Ratio. Note 
that these graphics text characters 
can be rotated on 0, 90, 180, and 
270 degree base lines. 

The driver supports six kinds of 
Graphic Markers. Each marker 
has five possible sizes in Preserve 
Aspect and five sizes in Non- 
preserve Aspect Ratio. The six 
kinds of markers are shown in 
the following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 

Filled areas, bars, pie slices and 
circles are all displayed using the 
current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, and HATCH 
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Color 



Request Locator 



are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

In graphics mode, there are two available 
colors that can be used to display graphic 
primitives. Color index is displayed as 
Black, and color index 1 is displayed as 
white. These colors can not be redefined. 

When locator is invoked on the UNIX PC, a 
tracking cross appears on the display at the 
initial locator position. The cross can be 
moved by moving the attached mouse. 
When the cross is at the desired location, the 
point can be selected by pressing the left 
mouse button. This causes the coordinates of 
the point to be transmitted back to the 
application program. 

If desired, the device will perform an inking 
function. When the locator is terminated, a 
line from the initial position to the desired 
position is drawn honoring the current line 
attributes such as color and line style. 

Also the device performs rubberbanding if 
desired. There are two types of 
rubberbanding supported: lines and 
rectangles. If rubberbanding lines are 
desired, a line will be drawn from the initial 
locator position to the current position of the 
graphic cursor. The line changes dynamically 
as the cursor is moved. When the locator is 
terminated, the line is removed. 
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Request Choice 

Request String 

Cursor 

Addressable 

Text 



Alpha Text 



VDI Opcode 
Summary 



If rubberband rectangle is specified, a 
rectangle is displayed with one corner at the 
initial locator position and the opposite at the 
current position of the graphic cursor. The 
rectangle changes dynamically as the cursor 
is moved. When the locator is terminated, 
the rectangle is removed from the display. 

The function keys (FT) to (F8) on the keyboard 
are used to enter choice input. 

The keyboard is used to enter strings. The 
string is terminated by the Return key. 

Cursor addressable text is supported. The 
device Addressable Text must be in Cursor 
Addressing Mode before it can perform any 
cursor control functions. To display graphic 
primitives, the device must be removed from 
Cursor Addressing Mode. 

Alpha text can be positioned anywhere on 
the output page. The following text 
capabilities are available on the UNIX PC 
Display: 

One Font 

One Size 

Superscript and Subscript 

Underline 

Line spacing 

The functions available in the GSS VDI for 
the AT&T UNIX PC Model 7300 driver are: 

Clear Workstation 

Close Workstation 

Cursor Down 

Cursor Left 

Cursor Right 

Cursor Up 

Direct Cursor Address 

Enter Cursor Addressing Mode 

Erase to End of Line 

Erase to End of Screen 
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Exit Cursor Addressing Mode 

Home Cursor 

Open Workstation 

Graphic Input Cursor 

Set Alpha Text Position 

Set Input Mode 

Set Line Edit Characters 

Set Writing Mode — All sixteen Boolean 

writing modes are supported 
Update Workstation — No action is performed 

Primitives 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array 

Circle (uses filled area attributes) 

Filled Area 

Graphics Text 

Output Alpha Text 

Output Cursor Addressable Text 

Pie Slice (uses filled area attributes) 

Polyline 

Polymarker 

Attributes 

Reverse Video Off 

Reverse Video On 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode — Returns 

default value 
Set Alpha Text Quality — Returns default 

value 
Set Alpha Text Script Mode 
Set Alpha Text Underline Mode 
Set Background Color Index 
Set Graphics Text String Baseline Rotation 
Set Character Height 
Set Color Representation — Returns default 

settings 
Set Cursor Text Attributes 
Set Cursor Text Color Indices — Only the 

foreground color can be selected 
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Set Fill Color Index 

Set Fill Interior Style 

Set Fill Style Index 

Set Graphics Text Alignment 

Set Graphics Text Color Index 

Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Input 

Input Locator — Request Mode 
Input Choice — Request Mode 
Input String — Request Mode 
Read Cursor Movement Keys 

Inquiries 

Inquire Alpha Text Capabilities 
Inquire Alpha Cell Location 
Inquire Alpha Font Availability 
Inquire Alpha Text Position 
Inquire Alpha String Extent 
Inquire Addressable Character Cells 
Inquire Color Representation 
Inquire Cell Array 
Inquire Current Cursor Address 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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CIT-101e Terminal with CIG-101e 
Graphics Card 



File Name 



citlOl 



Device Type DISPLAY 

Communications Serial (RS-232) 



Features 
Supported 



Polylines 



Lines and arcs can be drawn with 
the seven line styles listed below: 

Solid 

Long Dash 



3 Dotted 

4 . . Dash Dotted 

5 Medium Dashed 

6 . . . . Dash Two Dots 

7 Short Dash 

Graphics This device driver supports four 
Text character sizes with a Preserve 

Aspect Ratio and four sizes in a 
Non-preserve Aspect Ratio. Note 
that these graphics text characters 
cannot be rotated. 

Graphic The driver supports six kinds of 
Markers Graphic Markers. Each marker 

has five possible sizes in Preserve 
Aspect Ratio and five sizes in 
Non-preserve Aspect Ratio. The 
six kinds of markers are shown in 
the following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 

Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
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Color 



Request Locator 



Request Choice 
Request String 



index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

The CIG-lOle graphics card supports two 
simultane- ously displayable colors. These 
colors cannot be remapped. 

When locator is invoked, a tracking cross 
appears on the display at the initial locator 
position. The cross can be moved by 
pressing one of the four arrow keys on the 
keyboard. 

Initially, the cross moves in small 
increments. Holding an arrow key down, 
will cause the cross to move faster after a 
slight delay. When the cross is at the desired 
location, that point can be selected by 
pressing any alpha key on the keyboard. 
This causes the coordinates of point to be 
transmitted back to the user program. If 
desired, the device will perform an inking 
function. When the locator is terminated, a 
line from the initial position to the desired 
position is drawn honoring the current line 

The numeric keys to 9 on the keypad are 
used to enter choice input. 

The keyboard is used to enter strings. All 
strings are terminated by the Return key. 
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Cursor Cursor addressable text is supported. The 

Addressable terminal must be in Cursor Addressing Mode 

Text before it can perform any cursor control 

functions. The following attributes are 

supported: 

Reverse Video 

Blink 

Underline 

To display graphics primitives, the device 
must be removed from Cursor Addressing 
Mode. 

Alpha Text Alpha text can be positioned anywhere on 

the output page. The following text 
capabilities are available: 

One Font 

One Size 

Superscript and Subscript 

Underline 

Line spacing 

VDI Opcode The functions available in the GSS VDI for 

Summary the CitlOl driver are: 

Clear Workstation 

Close Workstation 

Cursor Down 

Cursor Left 

Cursor Right 

Cursor Up 

Direct Cursor Address 

Enter Cursor Addressing Mode 

Erase to End of Line 

Erase to End of Screen 

Exit Cursor Addressing Mode 

Home Cursor 

Open Workstation 

Remove Graphics Input Cursor 

Set Alpha Text Position 

Set Input Mode 

Set Line Edit Characters 
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Set Writing Mode — Modes supported 
include: 

1— Clear (dots off) 

7— XOR 

8— Overstrike (OR) Update 
Workstation — No action is performed 

Primitives 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array 

Circle (uses filled area attributes) 

Filled Area 

Graphics Text 

Output Alpha Text 

Output Cursor Addressable Text 

Pie Slice (uses filled area attributes) 

Polyline 

Polymarker 

Attributes 

Reverse Video Off 

Reverse Video On 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode — Returns 

default value 
Set Alpha Text Quality — Returns default 

value 
Set Alpha Text Script Mode 
Set Alpha Text Underline Mode 
Set Background Color Index 
Set Graphics Text String Baseline Rotation 
Set Character Height 
Set Color Representation 
Set Cursor Text Attributes 
Set Cursor Text Color Indices 
Set Fill Color Index 
Set Fill Interior Style 
Set Fill Style Index 
Set Graphics Text Alignment 
Set Graphics Text Color Index 
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Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Input 

Input Locator — Request Mode 
Input Choice — Request Mode 
Input String — Request Mode 
Read Cursor Movement Keys 

Inquiries 

Inquire Alpha Text Capabilities 
Inquire Alpha Cell Location 
Inquire Alpha Font Availability 
Inquire Alpha Text Position 
Inquire Alpha String Extent 
Inquire Addressable Character Cells 
Inquire Color Representation 
Inquire Current Cursor Address 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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CIT-161 Terminal with CIG-267 
Graphics Card 



File Name 



citl61 



Device Type DISPLAY 

Communications Serial (RS-232) 



Features 
Supported 



Polylines Lines and arcs can be drawn with 
the seven line styles listed below: 

1 Solid 

2 Long Dash 



3 Dotted 

4 . . Dash Dotted 

5 Medium Dashed 

6 . . . . Dash Two Dots 

7 Short Dash 

Graphics This device driver supports four 
Text character sizes with a Preserve 

Aspect Ratio and four sizes in a 
Non-preserve Aspect Ratio. Note 
that these graphics text characters 
cannot be rotated. 

Graphic The driver supports six kinds of 
Markers Graphic Markers. Each marker 

has five possible sizes in Preserve 
Aspect Ratio and five sizes in 
Non-preserve Aspect Ratio. The 
six kinds of markers are shown in 
the following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 == Circle 

5 = X 

6 = Diamond 

Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
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Color 



Request Locator 



Request Choice 
Request String 



index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

The CIG-267 graphics card supports eight 
simultaneously displayable colors. These 
colors cannot be remapped. 

When locator is invoked, a tracking cross 
appears on the display at the initial locator 
position. The cross can be moved by 
pressing one of the four arrow keys on the 
keyboard. Initially, the cross moves in small 
increments. Holding an arrow key down, 
will cause the cross to move faster after a 
slight delay. When the cross is at the desired 
location, that point can be selected by 
pressing any alpha key on the keyboard. 
This causes the coordinates of the point to be 
transmitted back to the user program. 

If desired, the device will perform an inking 
function. When the locator is terminated, a 
line from the initial position to the desired 
position is drawn honoring the current line 
attributes such as color and line style. 

The numeric keys to 9 on the keypad are 
used to enter choice input. 

The keyboard is used to enter strings. All 
strings are terminated by the Return key. 
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Cursor Cursor addressable text is supported. The 

Addressable terminal must be in Cursor Addressing Mode 

Text before it can perform any cursor control 

functions. The following attributes are 

supported: 

Reverse Video 
Blink 
Underline 
Bold Intensity 

Colors: 

= Black 

1 = White 

2 = Red 

3 = Green 

4 = Blue 

5 = Yellow 

6 = Cyan 

7 = Magenta 

To display graphics primitives, the device 
must be removed from Cursor Addressing 
Mode. 

Alpha Text Alpha text can be positioned anywhere on 

the output page. The following text 
capabilities are available: 

One Font 

One Size 

Superscript and Subscript 

Bold 

Underline 

Line Spacing 

Eight Colors 

VDI Opcode The functions available in the GSS VDI for 

Summary the citl61 driver are: 

Clear Workstation 
Close Workstation 
Cursor Down 



C-24 Device- Dependent Information 



Cursor Left 

Cursor Right 

Cursor Up 

Direct Cursor Address 

Enter Cursor Addressing Mode 

Erase to End of Line 

Erase to End of Screen 

Exit Cursor Addressing Mode 

Home Cursor 

Open Workstation 

Remove Graphics Input Cursor 

Set Alpha Text Position 

Set Input Mode 

Set Line Edit Characters 

Set Writing Mode— Only REPLACE mode is 

supported 
Update Workstation — No action is performed 

Primitives 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array 

Circle (uses filled area attributes) 

Filled Area 

Graphics Text 

Output Alpha Text 

Output Cursor Addressable Text 

Pie Slice (uses filled area attributes) 

Polyline 

Polymarker 

Attributes 

Reverse Video Off 

Reverse Video On 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode — Returns 

default value 
Set Alpha Text Quality — Returns default 

value 
Set Alpha Text Script Mode 
Set Alpha Text Underline Mode 
Set Background Color Index 
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Set Graphics Text String Baseline Rotation 

Set Character Height 

Set Color Representation 

Set Cursor Text Attributes 

Set Cursor Text Color Indices 

Set Fill Color Index 

Set Fill Interior Style 

Set Fill Style Index 

Set Graphics Text Alignment 

Set Graphics Text Color Index 

Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Input 

Input Locator — Request Mode 
Input Choice — Request Mode 
Input String — Request Mode 
Read Cursor Movement Keys 

Inquiries 

Inquire Alpha Text Capabilities 
Inquire Alpha Cell Location 
Inquire Alpha Font Availability 
Inquire Alpha Text Position 
Inquire Alpha String Extent 
Inquire Addressable Character Cells 
Inquire Color Representation 
Inquire Current Cursor Address 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inouire Current Polvmarker Attributes 
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Diablo C150 Ink Jet Color Printer 



File Name 



diabl50 



Device Type PRINTER 

Communications Parallel 

A Centronics standard parallel cable will 
operate the Diablo printer properly. 



Features 
Supported 



Polylines 



Lines and arcs can be drawn with 
the seven line styles listed below: 

Solid 

Long Dash 



3 Dotted 

4 . . Dash Dotted 

5 Medium Dashed 

6 . . . . Dash Two Dots 

7 Short Dash 

Graphics This printer supports twelve 
Text character sizes with a Preserve 

Aspect Ratio and twelve sizes in 
a Non-preserve Aspect Ratio. 
Note that these graphics text 
characters can be rotated on 0, 
90, 180, and 270 degree base 
lines. 

Graphic The driver supports six kinds of 
Markers Graphic Markers. Each marker 

has five possible sizes in Preserve 
Aspect Ratio and five sizes in 
Non-preserve Aspect Ratio. The 
six kinds of markers are shown in 
the following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 
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Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

Color The printer supports eight colors. They are 

defined as follows: 

= Background (not displayed) 

1 = Black 

2 = Red 

3 = Green 

4 = Blue 

5 = Yellow 

6 = Violet 

7 = Orange 

These colors cannot be redefined. 

Alpha Text Alpha text can be positioned anywhere on 

the output page. The following text 
capabilities are available on the Diablo 
printer: 

Fonts: 1 — Normal 

Sizes: 1 — 12 characters per inch 

Underline 

Overstrike Mode 

Pass Through Mode 
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VDI Opcode The functions available in the GSS VDI for 

Summary the Diablo Printer are: 

Clear Workstation — Causes picture 

generation; advances paper 
Close Workstation — Causes picture 

generation 
Open Workstation — Advances the paper 
Set Alpha Text Position 
Set Writing Mode — Replace mode only 
Update Workstation — Causes picture 

generation; subsequent output is 

overlaid. 

Output 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array — Outlines the area, no other 

action 
Circle (uses filled area attributes) 
Filled Area 
Graphics Text 
Output Alpha Text 
Output Cursor Addressable Text — Transmits 

string to printer immediately 
Pie Slice (uses filled area attributes) 
Polyline 
Polymarker 

Attributes 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode 

Set Alpha Text Quality 

Set Alpha Text Script Mode 

Set Alpha Text Underline Mode 

Set Graphics Text String Baseline Rotation 

Set Character Height 

Set Color Representation — Returns default 

settings 
Set Fill Color Index 
Set Fill Interior Style 
Set Fill Style Index 
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Set Graphics Text Alignment 

Set Graphics Text Color Index 

Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Inquiries 

Inquire Alpha Text Capabilities 

Inquire Alpha Cell Location 

Inquire Alpha Font Availability 

Inquire Alpha Text Position 

Inquire Alpha String Extent 

Inquire Addressable Character Cells — Will 

return (-1,-1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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Epson MX-100 



File Name 


epmxlOO 




Device Type 


PRINTER 




Communications 


Parallel 

A Centronics standard parallel cable will 

operate the Epson MX-100 printer properly. 


Features 
Supported 


Polylines 


Lines and arcs can be drawn with 
the seven line styles listed below: 




1 

2 

3 . . 

4 

5 

6 
7 


Solid 
Long Dash 




Dotted 

. Dash Dotted 




Medium Dashed 

. . Dash Two Dots 
Short Dash 




Graphics 
Text 


This printer supports twelve 
character sizes with a Preserve 



Aspect Ratio and twelve sizes in 
a Non-preserve Aspect Ratio. 
Note that these graphics text 
characters can be rotated on 0, 
90, 180, and 270 degree base 
lines. 

Graphic The driver supports six kinds of 
Markers Graphic Markers. Each marker 

has five possible sizes in Preserve 
Aspect Ratio and five sizes in 
Non-preserve Aspect Ratio. The 
six kinds of markers are shown in 
the following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 
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Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

Color The Epson MX-100 printer supports two 

colors. Index 1 is displayed with the black 
ribbon and index is not displayed. These 
colors cannot be redefined. 

Alpha Text Alpha text can be positioned anywhere on 

the output page. The following text 
capabilities are available on the Epson 
MX-100 printer: 

Fonts: 1 = Normal (default) 
2 = Bold 

Sizes: 1 = 16.5 characters per inch 

2 = 10 characters per inch (default) 

3 = 5 characters per inch 

Superscript and Subscript 

Underline 

Overstrike Mode 

Pass through Mode 

Alpha Text Quality: 
<50 : Turn on bi-direction printing 
5:50 : Turn off bi-direction printing 
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VDI Opcode The functions available in the GSS VDI for 

Summary the Epson MX-100 printer are: 

Clear Workstation — Causes picture 

generation; advances paper 
Close Workstation — Causes picture 

generation 
Open Workstation — Advances the paper 
Set Alpha Text Position 
Set Writing mode — Mode 4 (replace) and 

mode 8 (overstrike) are supported 
Update Workstation — Causes picture 

generation subsequent output is overlaid. 

Output 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array — Outlines the area, no other 

action 
Circle (uses filled area attributes) 
Filled Area 
Graphics Text 
Output Alpha Text 
Output Cursor Addressable Text — Transmits 

string to printer immediately 
Pie Slice (uses filled area attributes) 
Polyline 
Polymarker 

Attributes 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode 

Set Alpha Text Quality 

Set Alpha Text Script Mode 

Set Alpha Text Underline Mode 

Set Graphics Text String Baseline Rotation 

Set Character Height 

Set Color Representation — Returns default 

settings 
Set Fill Color Index 
Set Fill Interior Style 
Set Fill Style Index 
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Set Graphics Text Alignment 

Set Graphics Text Color Index 

Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Inquiries 

Inquire Alpha Text Capabilities 

Inquire Alpha Cell Location 

Inquire Alpha Font Availability 

Inquire Alpha Text Position 

Inquire Alpha String Extent 

Inquire Addressable Character Cells — Will 

return (-1,-1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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Epson MX-80 with Graphtrax Plus 



File Name 
Device Type 
Communications 



Features 
Supported 



epmx80 

PRINTER 

Parallel 

A Centronics standard parallel cable will 

operate the Epson MX-80 printer properly. 

Serial (RS-232) 

To communicate with the Epson serially 
requires an optional serial interface card to be 
installed in the Epson. 

Polylines Lines and arcs can be drawn with 
the seven line styles listed below: 

1 Solid 

2 Long Dash 

3 Dotted 

4 . . Dash Dotted 

5 Medium Dashed 

6 . . . . Dash Two Dots 

7 Short Dash 

Graphics This printer supports twelve 
Text character sizes with a Preserve 

Aspect Ratio and twelve sizes in 
a Non-preserve Aspect Ratio. 
Note that these graphics text 
characters can be rotated on 0, 
90, 180, and 270 degree base 
lines. 

Graphic The driver supports six kinds of 
Markers graphic markers, as shown in the 
following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 
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Each marker has five possible 
sizes in Preserve Aspect Ratio 
and five sizes in Non-preserve 
Aspect Ratio. 

Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

Color The MX-80 printer supports two colors. 

Index 1 is displayed with the black ribbon 
and index is not displayed. These colors 
cannot be redefined. 

Alpha Text Alpha Text can be positioned anywhere on 

the output page. The following text 
capabilities are available on the Epson MX-80: 

Fonts: 1 = Normal (default) 

2 = Bold 

3 = Italics 

Sizes: 1 = 17.16 characters per inch 

2 — 10 characters per inch (default) 

Superscript and Subscript 

Underline 

Overstrike Mode 

Pass Through Mode 
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Alpha Text Quality: 
<50 : Turn on bi-direction printing 
2:50 : Turn off bi-direction printing 

VDI Opcode The functions available in the GSS VDI for 

Summary the Epson MX-80 printer are: 

Clear Workstation — Causes picture 

generation; advances paper 
Close Workstation — Causes picture 

generation 
Open Workstation 
Set Alpha Text Position 
Set Writing Mode — Mode 4 (replace) and 

mode 8 (overstrike) are supported 
Update Workstation — Causes picture 

generation subsequent output is overlaid. 

Output 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array — Outlines the area, no other 

action 
Circle (uses filled area attributes) 
Filled Area 
Graphics Text 
Output Alpha Text 
Output Cursor Addressable Text — Transmits 

string to printer immediately 
Pie Slice (uses filled area attributes) 
Polyline 
Polymarker 

Attributes 

Set Alpha Text Color 
Set Alpha Text Font and Size 
Set Alpha Text Line Spacing 
Set Alpha Text Overstrike Mode 
Set Alpha Text Pass Through Mode 
Set Alpha Text Quality 
Set Alpha Text Script Mode 
Set Alpha Text Underline Mode 
Set Graphics Text String Baseline Rotation 
Set Character Height 

Set Color Representation — Returns default 
settings 
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Set Fill Color Index 

Set Fill Interior Style 

Set Fill Style Index 

Set Graphics Text Alignment 

Set Graphics Text Color Index 

Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Inquiries 

Inquire Alpha Text Capabilities 

Inquire Alpha Cell Location 

Inquire Alpha Font Availability 

Inquire Alpha Text Position 

Inquire Alpha String Extent 

Inquire Addressable Character Cells — Will 

return (-1,-1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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Hewlett-Packard 7470A Plotter 



File Name 
Device Type 
Communications 



Features 
Supported 



hp7470 

PLOTTER 

Serial (RS-232) 

To communicate with the Hewlett Packard 
7470A requires that the plotter have the serial 
interface installed. 

Polylines Lines and arcs can be drawn with 
the six line styles listed below: 



1 


Solid 


2 


Long Dash 


3 . . 


Dotted 


4 


. Dash Dotted 


5 


Medium Dashed 


6 


. . Dash Two Dots 


Graphics 


The plotter supports continuous 


Text 


character scaling. This text can 




be rotated in increments of one- 




tenth of a degree. 


Graphics 


The driver supports six kinds of 


Markers 


graphic markers, as shown in the 




following list: 




1 = Dot 




2 = Cross 




3 = Star 




4 = Circle 




5 = X 




6 = Diamond 



Each marker has five possible 
sizes in Preserve Aspect Ratio 
and five sizes in Non-preserve 
Aspect Ratio. 

Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
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Color 



Request Locator 



Alpha Text 



HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

Color 1 always is located in pen station 1. It 
is assumed to be a black pen. By default, 
color index 2 is located in pen station two. If 
the user program request is a color index 
other than what currently is in pen stations 
one or two, the user is prompted to insert the 
requested pen into pen station two. Color 
is not displayed. 

The pen holder is used to indicate what point 
is to input. The pen holder is moved by 
pressing the position keys on the front panel. 
When the pen holder is at the desired 
location, the point can be selected by 
pressing the Enter button. This causes the 
coordinates of the point to be transmitted 
back to the user program. 

Alpha text can be positioned anywhere on 
the output page. The following text 
capabilities are available on the plotter: 

Fonts: 1 = Normal (default) 

2 = Bold 

3 = Italics 

Sizes: 1 (default = 66 characters down page) 

Color 

Superscript and Subscript 
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Overstrike Mode 

Underlining 

VDI Opcode The functions available in the GSS VDI for 

Summary the Hewlett-Packard 7470A plotter are: 

Clear Workstation — Ask for paper change 

Close Workstation 

Open Workstation 

Set Alpha Text Position 

Set Input Mode — Request mode is only 

supported mode 
Set Pen Speed 
Set Writing Mode — Overstrike mode is the 

only supported mode 
Update Workstation — No action is performed 

Output 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array — Outlines the area, no other 

action 
Circle (uses filled area attributes) 
Filled Area 
Graphics Text 
Output Alpha Text 
Output Cursor Addressable Text — Transmits 

string to plotter with no error checking 
Pie Slice (uses filled area attributes) 
Polyline 
Polymarker 

Attributes 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode — Returns 

default value 
Set Alpha Text Quality — Returns default 

value 
Set Alpha Text Script Mode 
Set Alpha Text Underline Mode 
Set Graphics Text String Baseline Rotation 
Set Character Height 
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Set Color Representation — Returns default 

settings 
Set Fill Color Index 
Set Fill Interior Style 
Set Fill Style Index 
Set Graphics Text Alignment 
Set Graphics Text Color Index 
Set Graphics Text Font — Five fonts supported 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Input 

Input Locator — Request Mode 

Inquiries 

Inquire Alpha Text Capabilities 
Inquire Alpha Cell Location 
Inquire Alpha Font Availability 
Inquire Alpha Text Position 
Inquire Alpha String Extent 
Inquire Addressable Character Cells — 

Returns (-1, -1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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Hewlett-Packard 7475A Plotter 



File Name 
Device Type 
Communications 



Features 
Supported 



hp7475 

PLOTTER 

Serial (RS-232) 

To communicate with the Hewlett Packard 
7475A requires that the plotter have the serial 
interface installed. 



Polylines 



Lines and arcs can be drawn with 
the seven line styles listed below: 

1 Solid 

2 Long Dash 

3 Dotted 

4 . . Dash Dotted 

5 Medium Dashed 

6 . . . . Dash Two Dots 

7 Short Dash 

Graphics The plotter supports continuous 
Text character scaling. This text can 

be rotated in increments of one- 
tenth of a degree. 

Graphics The driver supports six kinds of 
Markers graphic markers, as shown in the 
following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 

Each marker has five possible 
sizes in Preserve Aspect Ratio 
and five sizes in Non-preserve 
Aspect Ratio for A-size and B-size 
paper. 
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Color 



Request Locator 



Alpha Text 



Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

Color indices 1 through 6 are mapped to pen 
stations 1 through 6 of the plotter. Color is 
not displayed. 

The pen holder is used to indicate what point 
is to be input. The pen holder is moved by 
pressing the position keys on the front panel. 
When the pen holder is at the desired 
location, the point can be selected by 
pressing the Enter button. This causes the 
coordinates of the point to be transmitted 
back to the user program. 

Alpha text can be positioned anywhere on 
the output page. The following text 
capabilities are available on the plotter: 

Fonts: 1 = Normal (default) 

2 = Bold 

3 = Italics 

Sizes: 1 (default = 66 characters down page) 

Color 

Superscript and Subscript 
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Overstrike Mode 

Underlining 

Special This driver will drive the plotter in both A 

Information and B size modes. The paper size can be 

selected by setting the rear dip switch or by 
pressing the Size pushbutton simultaneously 
with the Enter pushbutton. This should be 
done prior to running your application. 

VDI Opcode The functions available in the GSS VDI for 

Summary the Hewlett-Packard 7475A plotter are: 

Clear Workstation — Ask for paper change 

Close Workstation 

Open Workstation 

Set Alpha Text Position 

Set Input Mode — Request mode is only 

supported mode 
Set Pen Speed 
Set Writing Mode — Overstrike mode is the 

only supported mode 
Update Workstation — No action is performed 

Output 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array — Outlines the area, no other 

action 
Circle (uses filled area attributes) 
Filled Area 
Graphics Text 
Output Alpha Text 
Output Cursor Addressable Text — Transmits 

string to plotter with no error checking 
Pie Slice (uses filled area attributes) 
Polyline 
Polymarker 

Attributes 

Set Alpha Text Color 
Set Alpha Text Font and Size 
Set Alpha Text Line Spacing 
Set Alpha Text Overstrike Mode 
Set Alpha Text Pass Through Mode — Returns 
default value 
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Set Alpha Text Quality — Returns default 

value 
Set Alpha Text Script Mode 
Set Alpha Text Underline Mode 
Set Graphics Text String Baseline Rotation 
Set Character Height 
Set Color Representation 
Set Fill Color Index 
Set Fill Interior Style 
Set Fill Style Index 
Set Graphics Text Alignment 
Set Graphics Text Color Index 
Set Graphics Text Font — Five fonts supported 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Input 

Input Locator — Request Mode 

Inquiries 

Inquire Alpha Text Capabilities 
Inquire Alpha Cell Location 
Inquire Alpha Font Availability 
Inquire Alpha Text Position 
Inquire Alpha String Extent 
Inquire Addressable Character Cells — 

Returns (-1, -1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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Houston Instrument DMP-29 Plotter 



File Name 
Device Type 
Communications 



Features 
Supported 



hipt29 

PLOTTER 

Serial (RS-232) 

This interface has a maximum baud rate of 

9600. The Input Locator function of the 

driver will function at a maximum of 1200 

baud. 

Polylines Lines and arcs can be drawn with 
the six line styles listed below: 



1 


Solid 


2 


Long Dash 


3 , . 


Dotted 


4 


. Dash Dotted 


5 


Medium Dashed 


6 


. . Dash Two Dots 


Graphics 


The plotter supports continuous 


Text 


character scaling. This text can 




be rotated in increments of one- 




tenth of a degree. 


Graphics 


The driver supports six kinds of 


Markers 


graphic markers, as shown in the 




following list: 




1 = Dot 




2 = Cross 




3 = Star 




4 = Circle 




5 = X 




6 = Diamond 



Filled 
Areas 



Each marker has five possible 
sizes in Preserve Aspect Ratio 
and five sizes in Non-preserve 
Aspect Ratio. 

Filled areas, bars, pie slices and 
circles are all displayed using the 
current fill area attributes of 
color, interior style, and style 



Device- Dependent Information C-47 



Color 



Request Locator 



Alpha Text 



index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

Color indices 1 through 8 correspond to pen 
stations 1 through 8 of the plotter. Color is 
not displayed. 

The pen holder is used to indicate what point 
is to be input. To input a point, first the 
Local button must be pressed so that the 
plotter can be operated manually. Then the 
pen holder is moved by pressing the position 
keys on the front panel. When the pen is at 
the desired location, the point can be selected 
by pressing the Report Status button. This 
causes the coordinates of the point to be 
transmitted back to the user program. Then 
the Remote button must be pressed to return 
control back to the user program. 

Alpha text can be positioned anywhere on 
the output page. The following text 
capabilities are available on the plotter: 

Fonts: 1 = Normal (default) 

2 = Bold 

3 = Italics 

Sizes: 1 (default = 66 characters down page) 

Color 

Superscript and Subscript 
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Overstrike Mode 

Underlining 

Special This driver drives the plotter in large paper 

Information mode only. 

VDI Opcode The functions available in the GSS VDI for 

Summary the Houston Instrument DMP-29 plotter are: 

Clear Workstation — Ask for paper change 

Close Workstation 

Open Workstation 

Set Alpha Text Position 

Set Input Mode — Request mode is the only 

supported mode 
Set Pen Speed 
Set Writing Mode — Overstrike mode is the 

only supported mode 
Update Workstation — No action is performed 

Output 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array — Outlines the area, no other 

action 
Circle (uses filled area attributes) 
Filled Area 
Graphics Text 
Output Alpha Text 
Output Cursor Addressable Text — Transmits 

string to plotter with no error checking 
Pie Slice (uses filled area attributes) 
Polyline 
Polymarker 

Attributes 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode — Returns 

default value 
Set Alpha Text Quality- Returns default value 
Set Alpha Text Script Mode 
Set Alpha Text Underline Mode 
Set Graphics Text String Baseline Rotation 
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Set Character Height 

Set Color Representation — Returns default 

settings 
Set Fill Color Index 
Set Fill Interior Style 
Set Fill Style Index 
Set Graphics Text Alignment 
Set Graphics Text Color Index 
Set Graphics Text Font — Five fonts supported 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width— Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Input 

Input Locator — Request Mode 

Inquiries 

Inquire Alpha Text capabilities 
Inquire Alpha Cell Location 
Inquire Alpha Font Availability 
Inquire Alpha Text Position 
Inquire Alpha String Extent 
Inquire Addressable Character Cells — 

Returns (-1, -1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
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NEC Model 7730 Letter Quality Printer 



File Name 


nec7730 


Device Type 


PRINTER 


Communications 


Parallel 

A Centronics standard parallel cable will 

operate the NEC printer properly. 


Features 
Supported 


Polylines Lines and arcs can be drawn with 
the seven line styles listed below: 




1 Solid 

2 Long Dash 



3 Dotted 

4 . . Dash Dotted 

5 Medium Dashed 

6 . . . . Dash Two Dots 

7 Short Dash 

Graphics This printer supports twelve 
Text character sizes with a Preserve 

Aspect Ratio and twelve sizes in 
a Non-preserve Aspect Ratio. 
Note that these graphics text 
characters can be rotated on 0, 
90, 180, and 270 degree base 
lines. 

Graphic The driver supports six kinds of 
Markers Graphic Markers. Each marker 

has five possible sizes in Preserve 
Aspect Ratio and five sizes in 
Non-preserve Aspect Ratio. The 
six kinds of markers are shown in 
the following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 



Device-Dependent Information C-51 



Filled Filled areas, bars, pie slices, and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

Color The NEC printer supports two colors. Index 

1 is displayed with the black ribbon and 
index is not displayed. These colors cannot 
be redefined. 

Alpha Text Alpha text can be positioned anywhere on 

the output page. The following text 
capabilities are available on the NEC printer: 

Fonts: 1 = Normal (default) 
2 = Bold 

Sizes: 1 = Courier 10 Thimble (10 cpi) 

Superscript and Subscript 

Underline 

Overstrike Mode 

Pass Through Mode 

Alpha Text Quality: 
<50 : Turn on bi-direction printing 
5:50 : Turn off bi-direction printing 



C-52 Device- Dependent Information 



VDI Opcode The functions available in the GSS VDI for 

Summary the NEC 7730 Printer are: 

Clear Workstation — Causes picture 

generation; advances paper 
Close Workstation — Causes picture 

generation 
Open Workstation — Advances the paper 
Set Alpha Text Position 
Set Writing Mode — Mode 4 (replace) and 

mode 8 (overstrike) are supported 
Update Workstation — Causes pitture 

generation; subsequent output is 

overlaid. 

Output 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array — Outlines the area, no other 

action 
Circle (uses filled area attributes) 
Filled Area 
Graphics Text 
Output Alpha Text 
Output Cursor Addressable Text — Transmits 

string to printer immediately 
Pie Slice (uses filled area attributes) 
Polyline 
Polymarker 

Attributes 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode 

Set Alpha Text Quality 

Set Alpha Text Script Mode 

Set Alpha Text Underline Mode 

Set Graphics Text String Baseline Rotation 

Set Character Height 

Set Color Representation — Returns default 

settings 
Set Fill Color Index 
Set Fill Interior Style 
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Set Fill Style Index 

Set Graphics Text Alignment 

Set Graphics Text Color Index 

Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Inquiries 

Inquire Alpha Text Capabilities 

Inquire Alpha Cell Location 

Inquire Alpha Font Availability 

Inquire Alpha Text Position 

Inquire Alpha String Extent 

Inquire Addressable Character Cells — Will 

return (-1, -1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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NEC Model 3550 Letter Quality Printer 



File Name 
Device Type 
Communications 



Features 
Supported 



nec3550 

PRINTER 

Parallel 

A Centronics standard parallel cable will 

operate the NEC printer properly. 



Polylines 



Lines and arcs can be drawn with 
the seven line styles listed below: 

Solid 

Long Dash 



3 Dotted 

4 . . Dash Dotted 

5 Medium Dashed 

6 . . . . Dash Two Dots 

7 Short Dash 

Graphics This printer supports twelve 
Text character sizes with a Preserve 

Aspect Ratio and twelve sizes in 
a Non-preserve Aspect Ratio. 
Note that these graphics text 
characters can be rotated on 0, 
90, 180, and 270 degree base 
lines. 

Graphic The driver supports six kinds of 
Markers Graphic Markers. Each marker 

has five possible sizes in Preserve 
Aspect Ratio and five sizes in 
Non-preserve Aspect Ratio. The 
six kinds of markers are shown in 
the following list: 

1 = Dot 

2 - Cross 

3 = Star 

4 = Circle 

5 - X 

6 = Diamond 
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Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

Color The NEC printer supports two colors. Index 

1 is displayed with the black ribbon and 
index is not displayed. These colors cannot 
be redefined. 

Alpha Text Alpha text can be positioned anywhere on 

the output page. The following text 
capabilities are available on the NEC printer: 

Fonts: 1 = Normal (default) 
2 = Bold 

4 = Proportionally spaced 

5 = Bold proportionally spaced 

Sizes: One size supported — Courier 10 

Thimble (10 cpi, constant spacing) or 
Bold PS Thimble (proportional spacing) 

Superscript and Subscript 

Underline 

Overstrike Mode 

Pass Through Mode 

Alpha Text Quality: 
<50 : Turn on bi-direction printing 
>50 : Turn off bi-direction printing 
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Special 
Information 



VDI Opcode 
Summary 



When a proportionally spaced alpha text font 
is desired, the user will be prompted to 
place the proportional space thimble into the 
NEC 3550, set the front switches correctly, 
and turn the power to the printer off and on. 

The functions available in the GSS VDI for 
the NEC 3550 Printer are: 

Clear Workstation — Causes picture 

generation; advances paper 
Close Workstation — Causes picture 

generation 
Open Workstation — Advances the paper 
Set Alpha Text Position 
Set Writing Mode — Mode 4 (replace) and 

mode 8 (overstrike) are supported 
Update Workstation — Causes picture 

generation; subsequent output is 

overlaid. 

Output 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array — Outlines the area, no other 

action 
Circle (uses filled area attributes) 
Filled Area 
Graphics Text 
Output Alpha Text 
Output Cursor Addressable Text — Transmits 

string to printer immediately 
Pie Slice (uses filled area attributes) 
Polyline 
Polymarker 

Attributes 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode 

Set Alpha Text Quality 

Set Alpha Text Script Mode 

Set Alpha Text Underline Mode 

Set Graphics Text String Baseline Rotation 
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Set Character Height 

Set Color Representation — Returns default 

settings 
Set Fill Color Index 
Set Fill Interior Style 
Set Fill Style Index 
Set Graphics Text Alignment 
Set Graphics Text Color Index 
Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Inquiries 

Inquire Alpha Text Capabilities 

Inquire Alpha Cell Location 

Inquire Alpha Font Availability 

Inquire Alpha Text Position 

Inquire Alpha String Extent 

Inquire Addressable Character Cells — Will 

return (-1, -1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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Nicolet Zeta 8 Plotter 



File Name 
Device Type 
Communications 



Features 
Supported 



zeta8 

PLOTTER 

Serial (RS-232) 

Communication with the Nicolet Zeta 8 
plotter is accomplished through the modem 
port J102. 



Polylines 



Lines and arcs can be drawn with 
the seven line styles listed below: 

Solid 

Long Dash 



3 Dotted 

4 . . Dash Dotted 

5 Medium Dashed 

6 . . . . Dash Two Dots 

7 _ Short Dash 



Graphics 


The plotter supports continuous 


Text 


character scaling. This text can 




be rotated in increments of one 




degree. 


Graphics 


The driver supports six kinds of 


Markers 


graphic markers, as shown in the 




following list: 




1 = Dot 




2 = Cross 




3 = Star 




4 = Circle 




5 = X 




6 = Diamond 



Filled 
Areas 



Each marker has five possible 
sizes in Preserve Aspect Ratio 
and five sizes in Non-preserve 
Aspect Ratio. 

Filled areas, bars, pie slices and 
circles are all displayed using the 
current fill area attributes of 
color, interior style, and style 
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index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

Color Color indices 1 through 8 are mapped to pen 

stations 1 through 8 of the plotter. Color is 
not displayed. 

Alpha Text Alpha text can be positioned anywhere on 

the output page. The following text 
capabilities are available on the plotter: 

Fonts: 1 = Normal (default) 
2 = Bold 

Sizes: 1 (default = 66 characters down page) 

Color 

Superscript and Subscript 

Overstrike Mode 

Underlining 

Special This driver expects the plotter to be set to use 

Information mode (GML/RS-232). The switch settings 

are shown below. 

Switch 1 

1 — ON (plot speed fast) 
2 — OFF (non-correct) 
3— ON (plot on) 
4 — OFF (non-print) 

Switch 2 

1 — ON (Inch resolution) 
2— ON (High resolution) 



C-60 Device-Dependent Information 



3— OFF (Monitor echo off) 

4 — OFF (No Line Turnaround Delay) 

5— OFF (No parity) 

6 — Don't care 

7— OFF (CTS/RTS with swl-2 set to OFF) 

8 — Reserved 

Switch 3 

1— OFF (GML mode) 

2— OFF (GML mode) 

3— OFF (GML mode) 

4— OFF (select limit) 

5— ON (virtual limit) 

6 — OFF (multiple pen) 

7 — OFF (ASA page size) 

8 — OFF (auto-sense pen pressure) 

Switch 4 

A— 8 (9600 baud) 
B — 3 (pen pressure) 

VDI Opcode The functions available in the GSS VDI for 

Summary the Nicolet Zeta 8 plotter are: 

Clear Workstation — Advance paper 

Close Workstation — Advance paper 

Open Workstation 

Set Alpha Text Position 

Set Input Mode — Request mode is only 

supported mode 
Set Pen Speed 
Set Writing Mode — Overstrike mode is the 

only supported mode 
Update Workstation — No action is performed 

Output 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array — Outlines the area, no other 

action 
Circle (uses filled area attributes) 
Filled Area 
Graphics Text 
Output Alpha Text 
Output Cursor Addressable Text — Transmits 

string to plotter with no error checking 
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Pie Slice (uses filled area attributes) 

Polyline 

Polymarker 

Attributes 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode — Returns 

default value 
Set Alpha Text Quality — Returns default 

value 
Set Alpha Text Script Mode 
Set Alpha Text Underline Mode 
Set Graphics Text String Baseline Rotation 
Set Character Height 
Set Color Representation 
Set Fill Color Index 
Set Fill Interior Style 
Set Fill Style Index 
Set Graphics Text Alignment 
Set Graphics Text Color Index 
Set Graphics Text Font — One font supported 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Inquiries 

Inquire Alpha Text Capabilities 
Inquire Alpha Cell Location 
Inquire Alpha Font Availability 
Inquire Alpha Text Position 
Inquire Alpha String Extent 
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Returns (-1, -1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 



C-62 Device-Dependent Information 



Okidata Microline 93 

Okidata Microline 84 with Step 2 Support 



File Name 
Device Type 
Communications 



Features 
Supported 



okid84 

PRINTER 

Parallel 

A Centronics standard parallel cable will 

operate the Okidata printer properly. 

Polylines Lines and arcs can be drawn with 
the seven line styles listed below: 



Solid 
Long Dash 



3 Dotted 

4 . . Dash Dotted 

5 Medium Dashed 

6 . . . . Dash Two Dots 

7 Short Dash 

Graphics This printer supports twelve 
Text character sizes with a Preserve 

Aspect Ratio and twelve sizes in 
a Non-preserve Aspect Ratio. 
Note that these graphics text 
characters can be rotated on 0, 
90, 180, and 270 degree base 
lines. 

Graphic The driver supports six kinds of 
Markers Graphic Markers. Each marker 

has five possible sizes in Preserve 
Aspect Ratio and five sizes in 
Non-preserve Aspect Ratio. The 
six kinds of markers are shown in 
the following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 
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Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

Color The Okidata printers support two colors. 

Index 1 is displayed with the black ribbon 
and index is not displayed. These colors 
cannot be redefined. 

Alpha Text Alpha text can be positioned anywhere on 

the output page. The following text 
capabilities are available on the Okidata 
printers: 

Fonts: 1 = Normal (default) 
2 = Bold 

Sizes: 1 = 17 characters per inch 

2 = 12 characters per inch 

3 = 10 characters per inch (default) 

Superscript and Subscript 

Underline 

Overstrike Mode 

Pass through Mode 

Alpha Text Quality: 
<50 : Enable Data Processing Mode 
5:50 : Enable Correspondence Quality Mode 

C-64 Device-Dependent Information 



VDI Opcode The functions available in the GSS VDI for 

Summary the Okidata 93 and 84 printers are: 

Clear Workstation — Causes picture 

generation; advances paper 
Close Workstation — Causes picture 

generation 
Open Workstation — Advances paper 
Set Alpha Text Position 
Set Writing Mode — Mode 4 (replace) and 

mode 8 (overstrike) are supported 
Update Workstation — Causes picture 

generation; subsequent output is 

overlaid. 

Output 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array — Outlines the area, no other 

action 
Circle (uses filled area attributes) 
Filled Area 
Graphics Text 
Output Alpha Text 
Output Cursor Addressable Text — Transmits 

string to printer immediately 
Pie Slice (uses filled area attributes) 
Polyline 
Polymarker 

Attributes 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode 

Set Alpha Text Quality 

Set Alpha Text Script Mode 

Set Alpha Text Underline Mode 

Set Graphics Text String Baseline Rotation 

Set Character Height 

Set Color Representation — Returns default 

settings 
Set Fill Color Index 
Set Fill Interior Style 

Device-Dependent Information C-65 



Set Fill Style Index 

Set Graphics Text Alignment 

Set Graphics Text Color Index 

Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width— Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Inquiries 

Inquire Alpha Text Capabilities 

Inquire Alpha Cell Location 

Inquire Alpha Font Availability 

Inquire Alpha Text Position 

Inquire Alpha String Extent 

Inquire Addressable Character Cells — Will 

return (-1,-1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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Okidata Microline 92 



File Name 


okid92 


Device Type 


PRINTER 


Communications 


Parallel 

A Centronics standard parallel cable will 

operate the Okidata printer properly. 


Features 
Supported 


Polylines Lines and arcs can be drawn with 
the seven line styles listed below: 




1 Solid 

2 Long Dash 



3 Dotted 

4 . . Dash Dotted 

5 Medium Dashed 

6 . . . . Dash Two Dots 

7 Short Dash 

Graphics This printer supports twelve 
Text character sizes with a Preserve 

Aspect Ratio and twelve sizes in 
a Non-preserve Aspect Ratio. 
Note that these graphics text 
characters can be rotated on 0, 
90, 180, and 270 degree base 
lines. 

Graphic The driver supports six kinds of 
Markers Graphic Markers. Each marker 

has five possible sizes in Preserve 
Aspect Ratio and five sizes in 
Non-preserve Aspect Ratio. The 
six kinds of markers are shown in 
the following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 
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Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

Color The Okidata printer supports two colors. 

Index 1 is displayed with the black ribbon 
and index is not displayed. These colors 
cannot be redefined. 

Alpha Text Alpha text can be positioned anywhere on 

the output page. The following text 
capabilities are available on the Okidata 
printer: 

Fonts: 1 = Normal (default) 
2 = Bold 

Sizes: 1 = 17 characters per inch 

2 = 12 characters per inch 

3 = 10 characters per inch (default) 

Superscript and Subscript 

Underline 

Overstrike Mode 

Pass Through Mode 

Alpha Text Quality: 

<50 : Enable Data Processing Mode 

2:50 : Enable Correspondence Quality Mode 
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VDI Opcode The functions available in the GSS VDI for 

Summary the Okidata 92 Printer are: 

Clear Workstation — Causes picture 

generation; advances paper 
Close Workstation — Causes picture 

generation 
Open Workstation — Advances the paper 
Set Alpha Text Position 
Set Writing Mode — Mode 4 (replace) and 

mode 8 (overstrike) are supported 
Update Workstation — Causes picture 

generation; subsequent output is 

overlaid. 

Output 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array — Outlines the area, no other 

action 
Circle (uses filled area attributes) 
Filled Area 
Graphics Text 
Output Alpha Text 
Output Cursor Addressable Text — Transmits 

string to printer immediately 
Pie Slice (uses filled area attributes) 
Polyline 
Polymarker 

Output 

Set Alpha Text Color — Returns default setting 

(1) 
Set Alpha Text Font and Size 
Set Alpha Text Line Spacing 
Set Alpha Text Overstrike Mode 
Set Alpha Text Pass Through Mode 
Set Alpha Text Quality 
Set Alpha Text Script Mode 
Set Alpha Text Underline Mode 
Set Graphics Text String Baseline Rotation 
Set Character Height 
Set Color Representation — Returns default 

settings 
Set Fill Color Index 
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Set Fill Interior Style 

Set Fill Style Index 

Set Graphics Text Alignment 

Set Graphics Text Color Index 

Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Inquiries 

Inquire Alpha Text Capabilities 

Inquire Alpha Cell Location 

Inquire Alpha Font Availability 

Inquire Alpha Text Position 

Inquire Alpha String Extent 

Inquire Addressable Character Cells — Will 

return (-1,-1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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Printronix MVP Printer 
Printronix P300 Printer 
Printronix P600 Printer 



File Name 
Device Type 
Communications 



prntrx 

PRINTER 

Serial (RS-232) 

To communicate to the Printronix Printers 
requires that the printers have an RS-232 
serial interface installed. 



Features 


Polylines 


Lines and arcs can be drawn with 


Supported 




the seven line styles listed below: 




1 


Solid 




2 


Long Dash 




3 . . 


Dotted 




4 

5 


. Dash Dotted 




Medium Dashed 




6 


. . Dash Two Dots 




7 


Short Dash 




Graphics 


This printer supports twelve 




Text 


character sizes with a Preserve 
Aspect Ratio and twelve sizes in 
a Non-preserve Aspect Ratio. 
Note that these graphics text 
characters can be rotated on 0, 
90, 180, and 270 degree base 
lines. 




Graphic 


The driver supports six kinds of 




Markers 


graphic markers, as shown in the 
following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 



Each marker has five possible 
sizes in Preserve Aspect Ratio 
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and five sizes in Non-preserve 
Aspect Ratio. 

Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 == Wide Crosshatch 

Color The Printronix supports two colors. Index 1 

is displayed with the black ink and index is 
not displayed. 

These colors cannot be redefined. 

Alpha Text Alpha text is generated in the Printronix 

Printer PLOT Mode using a 5 x 7 dot matrix 
pattern character font. Alpha Text can be 
positioned anywhere on the output page. 
The following text capabilities are available 
on the Printronix printers: 

Fonts: 1 — Normal (default) 

Sizes: 1-10 characters per inch 

*^iir>orsrrir»i and *MiV>crrir»t 

"-" "t "-■-"-" -""£•- - --■ "~ ------.-_--_--»-£- 

Underline 
Overstrike Mode 
Pass Through Mode 
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Special This driver allows the user to change the 

Information paper width independently. The valid 

options for paper are WIDE (13 inch output) 
and NARROW (8 inch output). The default 
is Narrow paper. 

The paper width option can be changed via 
the ENVIRONMENT capability of UNIX. To 
change the paper size enter one of the 
following commands at the UNIX command 
level: 

PAPERS WIDE 
export PAPER 
PAPER=NARROW 
export PAPER 

VDI Opcode The functions available in the GSS VDI for 

Summary the Printronix Printers are: 

Clear Workstation — Causes picture 

generation; advances paper 
Close Workstation — Causes picture 

generation 
Open Workstation — Advances the paper 
Set Alpha Text Position 
Writing Mode — All sixteen writing modes are 

supported 
Update Workstation — Causes picture 

generation; subsequent output is 

overlaid. 

Output 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array — Outlines the area, no other 

action 
Circle (uses filled area attributes) 
Filled Area 
Graphics Text 
Output Alpha Text 
Pie Slice (uses filled area attributes) 
Polyline 
Polymarker 
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Attributes 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode 

Set Alpha Text Script Mode 

Set Alpha Text Underline Mode 

Set Graphics Text String Baseline Rotation 

Set Character Height 

Set Color Representation — Returns default 

settings 
Set Fill Color Index 
Set Fill Interior Style 
Set Fill Style Index 
Set Graphics Text Alignment 
Set Graphics Text Color Index 
Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Inquiries 

Inquire Alpha Text Capabilities 

Inquire Alpha Cell Location 

Inquire Alpha Font Availability 

Inquire Alpha Text Position 

Inquire Alpha String Extent 

Inquire Addressable Character Cells — Will 

return (-1,-1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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Strobe Model 100— Single pen Plotter 
Strobe Model 200— Single pen Plotter 
Strobe Model 260— Eight pen Plotter 


File Name 


strobe 


Device Type 


PLOTTER 


Communications 


Serial (RS-232) 

Communication with the Strobe plotters 

requires that the serial interface be installed. 


Features 
Supported 


Polylines Lines and arcs can be drawn with 
the seven line styles listed below: 




1 Solid 

2 Long Dash 




3 Dotted 

4 . . Dash Dotted 
5 Medium Dashed 

6 . . . . Dash Two Dots 

7 Short Dash 



Graphics The plotter supports continuous 
Text character scaling. This text can 

be rotated in increments of ninety 

degrees. 

Graphics The driver supports six kinds of 
Markers graphic markers, as shown in the 
following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 

Each marker has five possible 
sizes in Preserve Aspect Ratio 
and five sizes in Non-preserve 
Aspect Ratio. 
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Color 



Request Locator 



Alpha Text 



Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 — Medium diagonal 

3 = Wide diagonal 

4 - Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

Nine color indices are allowed. Color indices 
1 to 8 refer to pen stations 1 to 8 on the 
model 260. Models 100 and 200 issue a pen 
change prompt for color changes and will 
continue on a carriage return. Color is not 
displayed. 

The pen holder is used to indicate what point 
is to be input. The pen holder is moved by 
pressing the position keys on the front panel. 
When the pen holder is at the desired 
location, the point can be selected by 
pressing the START/ENTER button. This 
causes the coordinates of the point to be 
transmitted back to the user program. 

Alpha text can be positioned anywhere on 
the output page. The following text 
capabilities are available on the blotter: 

Fonts: 1 = Normal (default) 
2 = Bold 

Sizes: 1 (default = 52 characters down page) 

Color 
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Superscript and Subscript 

Overstrike Mode 

Underlining 

Special The pen position must be set at the lower left 

Information corner of the plotting surface prior to 

performing Open Workstation. Performing 
an Open Workstation on the model 100 and 
200 sets the pen origin to the current pen 
position. 

VDI Opcode The functions available in the GSS VDI for 

Summary the Strobe plotter are: 

Clear Workstation — Ask for paper change 

Close Workstation 

Open Workstation 

Set Alpha Text Position 

Set Input Mode — Request mode is only 

supported mode 
Set Pen Speed — One speed only 
Set Writing Mode — Overstrike mode is the 

only supported mode 
Update Workstation — No action is performed 

Output 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array — Outlines the area, no other 

action 
Circle (uses filled area attributes) 
Filled Area 
Graphics Text 
Output Alpha Text 
Output Cursor Addressable Text — Transmits 

string to plotter with no error checking 
Pie Slice (uses filled area attributes) 
Polyline 
Polymarker 

Attributes 

Set Alpha Text Color 
Set Alpha Text Font and Size 
Set Alpha Text Line Spacing 
Set Alpha Text Overstrike Mode 
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Set Alpha Text Pass Through Mode 
Set Alpha Text Quality — Returns default 

value 
Set Alpha Text Script Mode 
Set Alpha Text Underline Mode 
Set Graphics Text String Baseline Rotation 
Set Character Height 
Set Color Representation 
Set Fill Color Index 
Set Fill Interior Style 
Set Fill Style Index 
Set Graphics Text Alignment 
Set Graphics Text Color Index 
Set Graphics Text Font — Four fonts 

supported 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Input 

Input Locator — Request Mode 

Inquiries 

Inquire Alpha Text Capabilities 
Inquire Alpha Cell Location 
Inquire Alpha Font Availability 
Inquire Alpha Text Position 
Inquire Alpha String Extent 
Inquire Addressable Character Cells — 

Returns (-1, -1) to indicate no cursor 

addressing functions 
Inquire Color Representation 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 

Tv-^.,.;^^ r\,~..~~4. r>~i„i:~~ au^l^i-.,. 

Inquire Current Polymarker Attributes 
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Summagraphics Summatablet 



File Name 



summatb 



Device Type TABLET 

Communications Serial (RS-232) 



Request Locator 



When locator is invoked via the tablet, a 
tracking cross appears at the center of the 
screen of the output echo device. As the 
tablet's puck is moved across the tablet 
surface its position is shown by the tracking 
cross on the display. When the cross is at 
the desired location, that point can be 
selected by pressing one of the buttons on 
the puck. This causes the coordinates of the 
point to be transmitted back to the user 
program along with an ASCII character code 
for the button(s) pressed. The character 
codes associated with the buttons are as 
follows: 



Character 


Left 


Middle 


Right 


<space> 

! 


X 


X 


X 


# 


X 


X 




$ 


X 




X 


% 




X 


X 


' 


X 


X 


X 



If desired, the output echo device will 
perform an inking function. When the 
locator is terminated, a line from the initial 
position to the desired position is drawn. 
The current line attributes of the output echo 
device, such as color and line style, are 
honored. 

Also the output echo device performs 
rubberbanding if desired. There are two 
types of rubberbanding supported, line and 
rectangle. If rubberbanding lines are desired, 
then a line will be drawn from the initial 
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Special 
Information 



VDI Opcode 
Summary 



locator position to the current position of the 
graphics cursor. The line changes 
dynamically as the cursor is moved. When 
the locator is terminated, the line is removed. 

If rubberband rectangle is specified, a 
rectangle is displayed with one corner at the 
initial locator position and the opposite at the 
current position of the graphics cursor. The 
rectangle changes dynamically as the cursor 
is moved. When the locator is terminated, 
the rectangle is removed from the display. 

This driver is an input only device and must 
be used in conjunction with an output echo 
display device. 

The functions available in the GSS VDI for 
the Summatablet are: 

Close Workstation 
Open Workstation 

Set Input Mode — Request mode is the only 
supported mode 

Input 

Input Locator — Request Mode 
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Tektronix 4105 Color Graphics Terminal 



File Name 

Device Type 

Maximum Baud 
Rate 



tek4105 

DISPLAY 

38400 



Communications Serial (RS-232) 

Polylines Lines and arcs can be drawn with 



Features 
Supported 



the seven line styles listed below: 

1 Solid 

2 Long Dash 

3 Dotted 

4 . . Dash Dotted 

5 Medium Dashed 

6 . . . . Dash Two Dots 

7 Short Dash 

Graphics This terminal supports 58 
Text character sizes. There is one base 

cell size for the smallest 
character. All other character 
sizes are multiples of the base 
size. The text characters can be 
rotated on 0, 90, 180, and 270 
degree base lines. 

Graphics The driver supports a total of 
Markers eleven markers, however, only 
the first six markers map to the 
VDI. All eleven markers are of a 
single size, and are shown in the 
following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 

7 = Period 

8 = Square 
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Color 



Request Locator 



9 = Square w/ black dot in center 

10 = Solid Diamond 

11 = Square w/ white dot in center 

Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, PATTERN, 
and HATCH are all supported by 
this device. The interior style of 
HOLLOW is simulated by 
drawing vectors. The interior 
style of SOLID causes the solid 
fills of the device to be mapped to 
the VDI for color and index 
number. Sixteen device- 
dependent fill styles are available 
for the fill interior style of 
PATTERN (See Appendix J of the 
operators manual). Six different 
fill styles are supported for the 
HATCH interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

The Tektronix 4105 terminal supports eight 
simultane- ously displayable colors. Each 
color index can be remapped to a new color 
via the Set Color Representation command. 
There are a total of 64 colors available for 
mapping. 

When locator is invoked, a tracking cross 
appears on the display at the initial locator 
position. The cross can be moved by using 
the joydisk on the 4105 keyboard. 

Initially, the cross moves in large increments. 
Holding down the shift key will cause the 
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Request Choice 

Request String 

Cursor 

Addressable 

Text 



cross to move slower. When the cross is at 
the desired location, that point can be 
selected by pressing any alpha key on the 
keyboard. This causes the coordinates of the 
point to be transmitted back to the user 
program. 

If desired, the device will perform an inking 
function. When the locator is terminated, a 
line from the initial position to the desired 
position is drawn honoring the current line 
attributes such as color and line style. 

The function keys Fl to F8 on the keyboard 
are used to enter choice input. 

The keyboard is used to enter strings. All 
strings are terminated with the Return key. 

Cursor addressable text is supported. The 
terminal must be in Cursor Addressing Mode 
before it can perform any cursor control 
functions. The following attributes are 
supported: 

Reverse Video 

Blink 

Underline 

Bold Intensity uses index 2 

Color — Foreground and Background 

Color Index 

= Black 

1 = White 

2 = Red 

3 = Green 

4 = Blue 

5 = Yellow 

6 = Cyan 

7 = Magenta 

To display graphics primitives, the device 
must be removed from Cursor Addressing 
Mode. 
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Alpha Text Alpha text can be positioned anywhere on 

the output page. The following text 
capabilities are available: 

One Font 

One Size 

Superscript and Subscript 

Bold 

Underline 

Line spacing 

Eight colors 

VDI Opcode The functions available in the GSS VDI for 

Summary the Tektronix 4105 terminal driver are: 

Clear Workstation 

Close Workstation 

Cursor Down 

Cursor Left 

Cursor Right 

Cursor Up 

Direct Cursor Address 

Enter Cursor Addressing Mode 

Erase to End of Line 

Erase to End of Screen 

Exit Cursor Addressing Mode 

Hardcopy — issues a screen hard copy 

command to the terminal 
Home Cursor 
Open Workstation 
Set Alpha Text Position 
Set Input Mode 
Set Line Edit Characters 
Set Writing Mode— Overstrike and REPLACE 

(index 4 and 8) mode are supported 
Update Workstation 

Primitives 

Arc (uses polyline attributes) 
Bar (uses filled area attributes) 
Cell Array 

Circle (uses filled area attributes) 
Filled Area 
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Graphics Text 

Output Alpha Text 

Output Cursor Addressable Text 

Pie Slice (uses filled area attributes) 

Polyline 

Polymarker 

Attributes 

Reverse Video Off 

Reverse Video On 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode — Returns 

default value 
Set Alpha Text Quality — Returns default 

value 
Set Alpha Text Script Mode 
Set Alpha Text Underline Mode 
Set Background Color Index 
Set Graphics Text String Baseline Rotation 
Set Character Height 
Set Color Representation 
Set Cursor Text Attributes 
Set Cursor Text Color Indices 
Set Fill Color Index 
Set Fill Interior Style 
Set Fill Style Index 
Set Graphics Text Alignment 
Set Graphics Text Color Index 
Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Input 

Input Locator — Request Mode 
Input Choice — Request Mode 
Input String — Request Mode 
Read Cursor Movement Keys 
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Inquiries 

Inquire Alpha Text Capabilities 
Inquire Alpha Cell Location 
Inquire Alpha Font Availability 
Inquire Alpha Text Position 
Inquire Alpha String Extent 
Inquire Addressable Character Cells 
Inquire Color Representation 
Inquire Current Cursor Address 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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Virtual Device Metafile (VDM) 



File Name ddmeta (device driver) 

Device Type METAFIL The default output metafile name 

is METAFILE.DAT. This name can be 
changed with the following commands: 

METAOUTPUT= filename 
export METAOUTPUT 



Communications Not applicable 
Not applicable 



Maximum Baud 
Rate 

Features 
Supported 



Polylines The six line styles listed below 

are guaranteed by the interpreter. 
Other index values are device- 
dependent, 

1 Solid 

2 _____ Long Dash 



3 Dotted 

4 . . . Dash Dotted 

5 _. Medium Dashed 

6 . . . . Dash Two Dots 

7 _ Short Dash 

Metafile supports sixteen polyline 
colors (assigned in a color table) 
and many (32767) line widths. 

Graphics Metafile supports many fonts, 
Text sizes and rotations (32767). 

Metafile supports 256 text colors, 
assigned in the color table. 
When the metafile device is 
opened via the Open Workstation 
opcode, the coordinate transform 
mode should be set to preserve 
aspect ratio (1) to ensure that the 
metafile can be transported and 
displayed correctly on other 
devices. 
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Graphics 
Markers 



Color 



Metafile supports six styles, 256 
colors and many (32767) marker 



sizes. 



1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 

Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

A color is selected by an index. The user can 
change the appearance of a color by selecting 
desired levels of the three color components: 
red, green and blue, that will make up the 
index. This can be used to create non-default 
colors such brown or orange. This new color 
will only be visible on color devices that 

= it __i_„ j _/•„••.•_ „. 

aiiUW CUiUx UciiiUiiOU. 

The metafile supports 256 color indices with 
many levels of red, green and blue. 
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Raster Writing 



Cursor 

Addressable 

Text 



Alpha Text 



The default colors are: 

= Black 

1 = White 

2 = Red 

3 = Green 

4 = Blue 

5 = Yellow 

6 = Cyan 

7 = Magenta 
8-15 = White 

Raster writing modes define how pixels are 
MODES set in the bit map. All sixteen raster 
writing modes (Boolean operations between 
source and destination pixels) are supported 
by the metafile. 

The following attributes are supported: 

Reverse Video 

Blink 

Bold Intensity 

Color — Expanded palette 

= Black 

1 = White 

2 = Red 

3 = Green 

4 = Blue 

5 = Yellow 

6 = Cyan 

7 = Magenta 
8-15 = White 

To display graphics primitives, the device 
must be removed from Cursor Addressing 
Mode. 

The following capabilities are supported: 

Underline 

Line spacing 

Superscript and Subscript 

Overs trike 
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VDI Opcode The functions available in the VDI for the 

Summary VDM are: 

Open Workstation 

Close Workstation 

Clear Workstation 

Update Workstation — No action is performed 

Exit Cursor Addressing Mode 

Enter Cursor Addressing Mode 

Cursor Up 

Cursor Down 

Cursor Left 

Cursor Right 

Home Cursor 

Erase to End of Screen 

Erase to End of Line 

Direct Cursor Address 

Set Writing Mode 

Output Alpha Text 

Output Cursor Addressable Text 

Set Pen Speed 

Primitives 

Polyline 

Polymarker 

Graphics Text 

Filled Area 

Cell Array 

Generalized Drawing Primitives 

Bar 

Arc 

Pie Slice 

Circle 

Attributes 

Set Background Index 

Reverse Video On 

Reverse Video Off 

Set Cursor Text Attributes 

Set Cursor Text Color Indices 

Set Alpha Text Line Spacing 

Set Alpha Text Font and Size 

Set Alpha Text Color Index 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode 
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Set Alpha Text Position 

Set Alpha Text Quality 

Set Alpha Text Subscript/Superscript Mode 

Set Alpha Text Underline Mode 

Set Character Height 

Set Graphics Text String Baseline Rotation 

Set Color Representation 

Set Polyline Line Type 

Set Polyline Line Width 

Set Polyline Color Index 

Set Polymarker Type 

Set Polymarker Scale 

Set Polymarker Color Index 

Set Graphics Text Alignment 

Set Graphics Text Font 

Set Text Color Index 

Set Fill Interior Style 

Set Fill Style Index 

Set Fill Color Index 

Inquiries 

Inquire Addressable Character Cells 
Inquire Alpha Text Font Availability 
Inquire Alpha Text Capabilities 
Inquire Alpha Text String Length 
Inquire Alpha Text Cell Location 
Inquire Alpha Text Position 
Inquire Color Representation 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
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VT100 Terminal with Retro-Graphics Card 



File Name 


vtlOOret 


Device Type 


DISPLAY 


Communications 


Serial (RS-232) 


Features 
Supported 


Polylines Lines and arcs can be drawn witr 
the seven line styles listed below: 




1 Solid 

2 Long Dash 



3 Dotted 

4 . . Dash Dotted 

5 Medium Dashed 

6 . . . . Dash Two Dots 

7 Short Dash 

Graphics This printer supports four 
Text character sizes with a Preserve 

Aspect Ratio and four sizes in a 
Non-preserve Aspect Ratio. Note 
that these graphics text characters 
cannot be rotated. 

Graphic The driver supports six kinds of 
Markers Graphic Markers. Each marker 

has five possible sizes in Preserve 
Aspect Ratio and five sizes in 
Non-preserve Aspect Ratio. The 
six kinds of markers are shown in 
the following list: 

1 = Dot 

2 = Cross 

3 = Star 

4 = Circle 

5 = X 

6 = Diamond 

Filled Filled areas, bars, pie slices and 

Areas circles are all displayed using the 

current fill area attributes of 
color, interior style, and style 
index. The interior styles of 
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Color 



Request Locator 



Request Choice 
Request String 



HOLLOW, SOLID, and HATCH 
are all supported by this device. 
The interior style of PATTERN is 
mapped to the HATCH interior 
style. Six different styles are 
supported for the HATCH 
interior style: 

1 = Narrow diagonal 

2 = Medium diagonal 

3 = Wide diagonal 

4 = Narrow Crosshatch 

5 = Medium Crosshatch 

6 = Wide Crosshatch 

The VT100 with Retro-Graphics supports two 
colors. Index 1 is displayed as the 
foreground color (white) and index is 
displayed as the background color (black). 
These colors cannot be remapped. 

When locator is invoked on the Retro- 
Graphics card a tracking cross appears on the 
display at the initial locator position. The 
cross can be moved by pressing one of the 
arrow keys on the keyboard. Initially, the 
cross moves in small increments. Holding 
the arrow key down will cause the cross 
movement to speed up after a short pause. 

When the cross is at the desired location, that 
point can be selected by pressing any alpha 
key on the keyboard. This causes the 
coordinates of the point to be transmitted 
back to the user program. If desired, the 
device will perform an inking function. 
When the locator is terminated, a line from 
the initial position to the desired position is 
drawn honoring the current line attributes 
such as color and line style. 

The numeric keys to 9 on the keyboard are 
used to enter choice input. 

The keyboard is used to enter strings. All 
strings are terminated by the Enter key. 
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Cursor Cursor addressable text is supported. The 

Addressable Text device must be in Cursor Addressing 

Text Mode before it can perform any cursor 

control functions. The following attributes 

are supported: 

Reverse Video 

Underline 

Blink 

Note 

Underline or Reverse video may not be active 
at the same time. The block cursor will allow 
reverse and the bar cursor will allow 
underline. 

Alpha Text Alpha text can be positioned anywhere on 

the output page. The following text 
capabilities are available on the Retro- 
Graphics card: 

One Font 

One Size 

Superscript and Subscript 

Underline 

Line spacing 

VDI Opcode The functions available in the GSS VDI for 

Summary the VT100 driver are: 

Clear Workstation 

Close Workstation 

Cursor Down 

Cursor Left 

Cursor Right 

Cursor Up 

Direct Cursor Address 

Enter Cursor Addressing Mode 

Erase to End of Line 

Erase to End of Screen 

Exit Cursor Addressing Mode 

Home Cursor 

Open Workstation 
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Remove Graphics Input Cursor 
Set Alpha Text Position 
Set Input Mode 
Set Line Edit Characters 
Set Writing Mode — The following modes are 
supported: 

1— Clear (Color 0) 

7— XOR 

16— All bits on (Color 255) 
Update Workstation — No action is performed 

Primitives 

Arc (uses polyline attributes) 

Bar (uses filled area attributes) 

Cell Array 

Circle (uses filled area attributes) 

Filled Area 

Graphics Text 

Output Alpha Text 

Output Cursor Addressable Text 

Pie Slice (uses filled area attributes) 

Polyline 

Polymarker 

Attributes 

Reverse Video Off 

Reverse Video On 

Set Alpha Text Color 

Set Alpha Text Font and Size 

Set Alpha Text Line Spacing 

Set Alpha Text Overstrike Mode 

Set Alpha Text Pass Through Mode — Returns 

default value 
Set Alpha Text Quality — Returns default 

value 
Set Alpha Text Script Mode 
Set Alpha Text Underline Mode 
Set Background Color Index 
Set Graphics Text String Baseline Rotation 
Set Character Height 
Set Color Representation 
Set Cursor Text Attributes 
Set Cursor Text Color Indices 
Set Fill Color Index 
Set Fill Interior Style 
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Set Fill Style Index 

Set Graphics Text Alignment 

Set Graphics Text Color Index 

Set Graphics Text Font — Returns default 

setting 
Set Polyline Color Index 
Set Polyline Type 

Set Polyline Width — Returns default setting 
Set Polymarker Type 
Set Polymarker Scale 
Set Polymarker Color Index 

Input 

Input Locator — Request Mode 
Input Choice — Request Mode 
Input String — Request Mode 
Input String — Sample Mode 
Read Cursor Movement Keys 

Inquiries 

Inquire Alpha Text Capabilities 
Inquire Alpha Cell Location 
Inquire Alpha Font Availability 
Inquire Alpha Text Position 
Inquire Alpha String Extent 
Inquire Addressable Character Cells 
Inquire Color Representation 
Inquire Current Cursor Address 
Inquire Current Fill Area Attributes 
Inquire Current Graphics Text Attributes 
Inquire Current Polyline Attributes 
Inquire Current Polymarker Attributes 
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ASCII Code Chart 



The following table is intended as a convenience, to provide you 
with the ASCII Character Codes that are used throughout the 
computer industry. 



CONTROL 


NUMBERS 
SYMBOLS 


UPPERCASE 


LOWER CASE 


NUL 




DLE 

76 


SP 

32 




48 


@ 

64 


P 

80 


96 


P 

772 


SOH 

7 


DC1 

17 


! 

33 


1 

49 


A 

65 


Q 

87 


a 

97 


q 

773 


STX 

2 


DC2 

18 


34 


2 

50 


B 

66 


R 

82 


b 

98 


r 

774 


ETX 

3 


DC3 

79 


35 


3 

57 


C 

67 


s 

83 


c 

99 


s 

775 


EOT 

4 


DC4 

20 


36 


4 

52 


D 

68 


T 

84 


d 

7 00 


t 

776 


ENQ 

5 


NAK 

27 


°/ 

/o 

37 


5 

53 


E 

69 


u 

85 


e 

707 


u 

777 


ACK 

6 


SYN 

22 


38 


6 

54 


F 

70 


V 

86 


f 

702 


V 

778 


BEL 

BELL 7 


ETB 

23 


J 

39 


7 

55 


G 

77 


w 

87 


g 

7 03 


w 

779 


BS 

BACKSPACE 8 


CAN 

24 


( 

40 


8 

56 


H 

72 


X 

88 


h 

704 


X 

720 


HT 

9 


EM 

25 


) 

41 


9 

57 


I 

73 


Y 

89 


i 

705 


y 

727 


LF 

10 


SUB 

26 


* 

42 


58 


J 

74 


z 

90 


J 

7 06 


Z 

7 22 


VT 

77 


ESC 

27 


+ 

43 


J 

59 


K 

75 


[ 

91 


k 

707 


! 

723 


FF 

72 


FS 

28 


1 

44 


< 

60 


L 

76 


\ 

92 


I 

7 08 


I 

I 

7 24 


CR 

RETURN 73 


GS 

29 


45 


67 


M 

77 


) 

93 


m 

7 09 


I 

7 25 


SO 

14 


RS 

30 


46 


> 

62 


N 

78 


A 

94 


n 

770 


7 26 


SI 

75 


US 

37 


/ 

47 


? 

63 




79 


95 




777 


RUBOUT 
(DEL) 

727 
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